Sessions

List sessions

List Sessions with cursor pagination.

get/v1/agents/sessions

Request

  • Base URL: https://api.sandbase.ai
  • URL: https://api.sandbase.ai/v1/agents/sessions
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

lifecycle_status'active' | 'archived' | 'all'

Lifecycle filter. Other values return 400.

agent_idstring

Only return Sessions of this Agent.

limitinteger

Page size. Values outside 1-100 return 400.

afterstring

Cursor. Pass last_id from the previous page.

order'asc' | 'desc'

Sort order by creation time.

Headers

OpenAI-Beta'agents=v1'

Optional OpenAI SDK header. When present it must be agents=v1.

Response

Session page

object'list' required
has_moreboolean required
first_idstring nullable required
last_idstring nullable required

Pass as after to read the next page.

Changes

No recorded changes to this operation across all 1 revision of this API.