Skip to main content
GET
Get a context

Authorizations

Authorization
string
header
required

OAuth 2.0 / OIDC bearer token.

Tenant-Name
string
header
required

The tenant the request operates within.

Path Parameters

contextId
string<context-id>
required

Context identifier (prefixed UUIDv7). Context identifier. Accepts ctx.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(ctx\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"ctx.0192f4c8-3d6b-7c4f-a02b-4d9e7f3c8b51"

Query Parameters

historyLength
integer

Cap the number of history messages returned per task.

Required range: x >= 0

Response

The context and its tasks.

A context together with its tasks. Returned by GET /contexts/{id}. Tasks are ordered oldest first and each carries its full message history — the user's prompt for a task is the ROLE_USER message within that task's history.

id
string<context-id>
required

Context identifier. Accepts ctx.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(ctx\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"ctx.0192f4c8-3d6b-7c4f-a02b-4d9e7f3c8b51"

tasks
object[]
required

The context's tasks, oldest first, each with full message history.

agentId
string<agent-id>

Agent identifier. Accepts agt.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(agt\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"

taskCount
integer
read-only

Total number of tasks in the context.

Required range: x >= 0
createdAt
string<date-time>

When the context was created.

updatedAt
string<date-time>

When the context was last updated.

expiresAt
string<date-time> | null

When the context expires; null means it does not expire. Not yet implemented — the server always returns null and performs no TTL-based cleanup.