Skip to main content
GET
/
v1
/
sessions
/
{sessionId}
Get session
curl --request GET \
  --url https://api.example.com/v1/sessions/{sessionId}
{
  "sessionId": "<string>",
  "tasks": [
    {}
  ]
}

​
Path parameters

​
sessionId
string
required
The session identifier (returned by POST /v1/tasks).

​
Response — 200 OK

​
sessionId
string
Echoed session identifier.
​
tasks
Task[]
All tasks in the session, ordered by createdAt ascending. Each task has the same shape as GET /v1/tasks/{taskId}.

​
Example

curl "$API_BASE/sessions/a31d..." \
  -H "Authorization: Bearer $API_KEY"

​
Use cases

  • Rebuild chat UI state after a page reload
  • Audit / support: inspect what your end-user actually asked
  • Customer-facing history pages — show your users their own conversation log
  • Analytics: compute per-session summaries from the full turn list

​
Errors

CodeMeaning
401Missing Authorization header
403Session belongs to another business
404Unknown sessionId, or session has zero tasks