Agent Sessions

Get History

Changed on

Get conversation history for a session.

Returns messages in chronological order (oldest first).

Args: request: FastAPI request with tenant context session_id: Session identifier limit: Maximum messages to return (default: 50, max: 200) offset: Pagination offset (default: 0)

Returns: GetHistoryResponse with message history

Raises: NotFoundError: If session not found

Example: bash curl -X GET "http://localhost:8000/v1/agents/sessions/ses_abc123/history?limit=20&offset=0" \ -H "Authorization: Bearer {api_key}" \ -H "X-Namespace: {namespace_id}"

get/v1/agents/sessions/{session_id}/history

Request

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

Path parameters

session_idstring required

Session ID

Query parameters

limitinteger

Maximum messages to return

offsetinteger

Pagination offset

Response

Successful Response

session_idstring required

Session identifier

total_messagesinteger required

Total messages in session

returned_messagesinteger required

Messages returned

has_moreboolean required

Whether more messages available

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