GET /sessions
List cloud agent sessions, newest first.
TypeScript SDKThe npm client, generated from the API spec.Python SDKThe PyPI client, sync and async.
| Method | Path |
|---|---|
| GET | /v1/sessions |
Optionally filtered by automation (id or name), source, time window, attributed author, repository, and whether the session is still going.
Query parameters
automationstring
An automation id, or its name: only sessions that automation started.
sourcearray<SessionSource>
daysinteger
startstring · date-time
endstring · date-time
limitdefault
50integercursorstring
author_idinteger
A GitHub account id (see GET /v1/integrations/github/members); scopes the list to sessions attributed to that developer.
repostring
"owner/name" (exact) or a bare repo name. Sessions whose repository is named only inside their agent config — dashboard starts, cron — do not match.
unfinisheddefault
falsebooleanKeep only sessions whose conversation is still going — live or idle — dropping the ones that completed, errored, or were stopped or cancelled. A session parked between turns counts as unfinished.
curl "https://api.ellipsis.dev/v1/sessions" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
for item in client.sessions.list():
print(item)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
for await (const item of client.sessions.list()) {
console.log(item);
}Request
Response
Example response · 200
{
"has_more": false,
"next_cursor": "string",
}