Agent Sessions

Terminate Session

Changed on

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}

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/agents/sessions/{session_id}
  • Auth: HTTP bearer and API key in header X-Namespace

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

Changes

  • 61a175e8eb9aRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 5d4c905106b4Revision changes
    • info

      the endpoint scheme security BearerAuth AND NamespaceHeader was added to the API