Sessions

Sessions hold conversation history and workspace context across many runs.

Create a new session when you want isolated work. Reuse the same session when later prompts should see earlier transcript and tool results.

Create a session

curl https://api.agentplatform.cloud/v1/sessions \
  -H "Authorization: Bearer $AP_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title":"Investigate support backlog"}'

Example response:

{
  "id": "sess_123",
  "status": "active",
  "title": "Investigate support backlog",
  "created_at": "2026-03-14T20:00:00Z",
  "updated_at": "2026-03-14T20:00:00Z"
}

List sessions

GET /v1/sessions returns sessions visible to the workspace-bound key.

Retrieve a session

GET /v1/sessions/{id} returns session metadata and transcript messages collected so far.

That transcript view is useful for history and debugging. For streaming and fine-grained run progress, use the associated run_event log instead.