Sign in

v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Agent Sessions

Get Session

Get session metadata by ID.

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

Returns: GetSessionResponse with session metadata

Raises: NotFoundError: If session not found

Example: bash curl -X GET http://localhost:8000/v1/agents/sessions/ses_abc123 \ -H "Authorization: Bearer {api_key}" \ -H "X-Namespace: {namespace_id}"

get/v1/agents/sessions/{session_id}

Path parameters

session_idstring required

Session ID

Session ID

Response

Successful Response

session_idstring required

Session identifier

namespace_idstring required

Namespace identifier

internal_idstring required

Organization internal ID

user_idstring nullable

User identifier

session_namestring nullable

Auto-generated session name based on first conversation

user_memoryobject

User memory/preferences

status'active' | 'idle' | 'archived' | 'terminated' required

Session lifecycle states.

Attributes: ACTIVE: Session is actively processing messages IDLE: Session exists but no recent activity ARCHIVED: Session archived (read-only) TERMINATED: Session permanently closed

message_countinteger required

Total messages in session

created_atstring date-time required

Creation timestamp

updated_atstring date-time required

Last update timestamp

last_activity_atstring date-time required

Last activity timestamp

expires_atstring date-time required

Expiration timestamp

Example response

{
  "agent_config": {
    "available_tools": [
      "list_retrievers",
      "get_retriever",
      "execute_retriever",
      "list_collections",
      "get_collection"
    ],
    "max_tokens": 4096,
    "model": "claude-sonnet-4-5-20250929",
    "system_prompt": "You are a video analysis assistant that helps users find and analyze video content.",
    "temperature": 0.7
  }
}