Get a session - Sempera Docs

GET

sessions

{session_id}

Get a session

curl --request GET \
  --url https://api.sempera.org/v1/sessions/{session_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sempera.org/v1/sessions/{session_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "<string>",
  "object": "session",
  "agent_id": "<string>",
  "channel": "web_voice",
  "status": "<string>",
  "started_at": "<unknown>",
  "ended_at": "<unknown>",
  "duration_s": "<unknown>",
  "outcome": "<unknown>",
  "language": "<unknown>",
  "agent_version_id": "<unknown>",
  "caller": "<unknown>",
  "summary": "<unknown>",
  "turns": "<array>",
  "recording": "<unknown>",
  "provider": "<unknown>",
  "call_id": "<unknown>",
  "runtime_identity": {
    "schema": "<unknown>",
    "traffic": {},
    "legs": {},
    "fallbacks": {},
    "worker": {},
    "latency": {},
    "verified": true
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

Authorizations

Authorization

string

header

required

A workspace API key, sent as Authorization: Bearer sempera_sk_... Each operation names the one scope it needs. Scopes, key kinds and roles are in the Authentication guide.

Path Parameters

session_id

string

required

Query Parameters

agent_id

string

Response

string

required

object

any

required

agent_id

string

required

channel

enum<string>

required

Available options:

web_voice,

web_chat,

simulator,

phone,

test,

unknown

status

string

started_at

any

ended_at

any

duration_s

any

outcome

any

language

any

agent_version_id

any

caller

any

summary

any

turns

array | null

recording

any

provider

any

call_id

any

runtime_identity

object | null

What heard, thought and spoke on this session, as a workspace member reads it: legs (stt, llm, tts: each with engine, model, machine as a category, and for tts ended_on), fallbacks (whether a leg handed over), worker (runtime origin or hosted, transport), latency timings, traffic (class: customer, demo, test or unrecorded) and verified, false when the stored block no longer matches its own integrity checksum. Engines and models carry Sempera's sealed names (engine_...), never a supplier's. null for a session recorded before the block existed.

Show child attributes

⌘I

Get a session

curl --request GET \
  --url https://api.sempera.org/v1/sessions/{session_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sempera.org/v1/sessions/{session_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "<string>",
  "object": "session",
  "agent_id": "<string>",
  "channel": "web_voice",
  "status": "<string>",
  "started_at": "<unknown>",
  "ended_at": "<unknown>",
  "duration_s": "<unknown>",
  "outcome": "<unknown>",
  "language": "<unknown>",
  "agent_version_id": "<unknown>",
  "caller": "<unknown>",
  "summary": "<unknown>",
  "turns": "<array>",
  "recording": "<unknown>",
  "provider": "<unknown>",
  "call_id": "<unknown>",
  "runtime_identity": {
    "schema": "<unknown>",
    "traffic": {},
    "legs": {},
    "fallbacks": {},
    "worker": {},
    "latency": {},
    "verified": true
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}