v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Agent Sessions

Terminate Session

Terminate a session and kill its actor.

This permanently ends the session and releases all associated resources.

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

Returns: TerminateSessionResponse with termination timestamp

Raises: NotFoundError: If session not found

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

delete/v1/agents/sessions/{session_id}

Path parameters

session_idstring required

Session ID

Response

Successful Response

session_idstring required

Session identifier

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

terminated_atstring date-time required

Termination timestamp