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
| 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. |
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer JWT token. |
| 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. |
Status: 200 OK
fast mode (default):
- Returns pre-indexed and precomputed context.
- Low latency.
- Parameters
query,latency_sensitivity, andtoken_budgetdo not apply. - Currently the only supported mode.
| Status Code | Description |
|---|---|
| 400 | Bad Request. Invalid query parameters or missing required fields. |
| 401 | Unauthorized. Invalid or missing JWT token. |
| 500 | Internal Server Error. |