DEdesplega-ai
Sessions

List recent task sessions (root tasks + chain summary)

Changed on

Each item's root is a slim task summary by default — the full task text is replaced with a bounded taskPreview and completion/integration blobs are dropped. Pass fields=full to restore the full root AgentTask. The full root + descendant chain are on GET /api/sessions/{rootTaskId}.

get/api/sessions

Request

  • Base URL
    http://localhost:3013
  • URL
    http://localhost:3013/api/sessions
  • Auth
    HTTP bearer

Query parameters

limitinteger nullable
offsetinteger nullable
sourcestring
qstring
requestedByUserIdstring
contextKeyPrefixstring
keyPrefixstring
groupKeystring
noGroup'true' | 'false'
triage'inbox' | 'later' | 'done' | 'unread'
status'running' | 'failed' | 'needs'
withUserIdstring
fields'full' | 'slim'
scope'mine' | 'shared' | 'tree'

mine: owned sessions. shared: sessions shared with me. tree: Sessions that GET /api/session-tree counts: mine plus shared with me, no ownerless roots. A bypass actor sees every root with tree scope.

show'mine' | 'all'

Sessions v2 view, for a user viewer with tree scope. mine (default): roots the user started from a human channel (not workflow, schedule, or system) plus sessions shared with the user. all: every tree session. Lists only: access is unchanged.

hideSourcestring

Comma-separated root sources to leave out, e.g. slack,chat. Older sessions v2 clients send this; showSource replaces it.

showSourcestring

Comma-separated root sources to keep (the sessions v2 source filter), e.g. ui,slack. Present and empty keeps none; omit to keep every source.

Response

Recent sessions ordered by chain-wide last activity

totalinteger required
limitinteger required
offsetinteger required

Changes

  • 305e33634408Revision changes
    • warning

      added the new fx enum value to the /////// response property for the response status

    • warning

      added the new fx enum value to the //////// response property for the response status

    • warning

      added the new fx enum value to the //// response property for the response status

  • 3d98aed9b483Revision changes
    • info

      added the new optional query request parameter showSource