Get Context

Retrieves assembled context for a profile. Returns context entries categorized by source type (profile, conversation, additional data graphs).

URI: /api/v1/agentic/context

HTTP Method: GET

Authentication: Bearer JWT

Query Parameters

Parameter	Type	Required	Description
agent_id	String	Yes	Agent identifier. Query parameter, not header.
conversation_id	String	Yes	Conversation identifier.
owner_id	String	No	Individual or User ID. If provided, `owner_type` is required.
owner_type	String	Conditional	Type of owner. Required when `owner_id` is present. Values: `individual`, `employee`.
mode	String	No	Context retrieval mode. Value: `fast` (pre-indexed).
latency_sensitivity	String	No	Latency sensitivity. Values: `low`, `medium`, `high`.
token_budget	Integer	No	Maximum token budget for response.

Request Headers

Header	Required	Description
Authorization	Yes	Bearer JWT token.

Response Body Schema

Field	Type	Description
contextId	String	Unique identifier for this context response. Use for tracing and debugging.
sessionId	String	Session identifier associated with this context.
createdAt	String (ISO 8601)	Timestamp when context was assembled.
userContext	Array	List of context entries.
userContext[].entry	String	Context content.
userContext[].sourceType	String	Source of the context entry. Values: `Profile`, `Conversation`, or other Data Graph names.

Example Response

Status: 200 OK

1{
2  "contextId": "ctx-abc-123",
3  "sessionId": "sess-A",
4  "createdAt": "2026-06-22T10:00:00Z",
5  "userContext": [
6    { "entry": "User prefers dark mode", "sourceType": "Profile" },
7    { "entry": "Last purchase: running shoes", "sourceType": "Conversation" }
8  ]
9}

Mode Behavior

fast mode (default):

Returns pre-indexed and precomputed context.
Low latency.
Parameters query, latency_sensitivity, and token_budget do not apply.
Currently the only supported mode.

Error Codes

Status Code	Description
400	Bad Request. Invalid query parameters or missing required fields.
401	Unauthorized. Invalid or missing JWT token.
500	Internal Server Error.

DID THIS ARTICLE SOLVE YOUR ISSUE?
Let us know so we can improve!