Endpoint Reference

GET `/sessions/{sessionId}`

Fetch current session snapshot and event history.

MethodGET
Path/sessions/{sessionId}
Endpoint3/3
Base Path/api/partner/v1/core-chat

GET `/sessions/{sessionId}`

Endpoint

Fetch current session snapshot and event history.

When to use:

  • Page refresh / conversation hydration
  • Reconcile state after retry/outage

Path params:

FieldTypeRequiredDescription
sessionIdstringYesExisting session ID in your tenant

Example request:

curl "$BREK_BASE_URL/api/partner/v1/core-chat/sessions/sess_1771456953407_g7p6233d" \
  -H "x-partner-api-key: $BREK_PARTNER_API_KEY"

Example success (200):

{
  "data": {
    "sessionId": "sess_1771456953407_g7p6233d",
    "tenantId": "demo-tenant",
    "actor": {
      "actorId": "partner_user_001"
    },
    "events": [
      {
        "eventId": "evt_1771456966998",
        "kind": "search_query",
        "resultStatus": "shortlist",
        "recordedAt": "2026-02-18T23:22:46.998Z"
      }
    ]
  }
}

Common errors:

  • 400: sessionId is required
  • 404: session_not_found
  • 401, 403, 429: auth/quota