v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Agent Sessions

Patch Session

Update session metadata.

Only user_memory can be updated. To change agent configuration, create a new session.

Args: request: FastAPI request with tenant context session_id: Session identifier payload: Update request

Returns: PatchSessionResponse with update timestamp

Raises: NotFoundError: If session not found

Example: bash curl -X PATCH http://localhost:8000/v1/agents/sessions/ses_abc123 \ -H "Authorization: Bearer {api_key}" \ -H "X-Namespace: {namespace_id}" \ -H "Content-Type: application/json" \ -d '{ "user_memory": { "preferences": {"language": "en", "domain": "tech"} } }'

patch/v1/agents/sessions/{session_id}

Path parameters

session_idstring required

Session ID

Session ID

Request body

user_memoryobject required

Updated user memory (REQUIRED)

Response

Successful Response

session_idstring required

Session identifier

updated_atstring date-time required

Update timestamp