Sessions
Real-time list of active voice sessions from Valkey (cross-pod).
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Successful Response
""""GET /v1/{workspace_id}/sessions/active HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Successful Response
[
{
"call_sid": "text",
"service_id": "123e4567-e89b-12d3-a456-426614174000",
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"caller_id": "text",
"direction": "text",
"duration_seconds": 1,
"current_state": "",
"scenario": ""
}
]Live Agones fleet capacity for the per-call voice fleet: Ready/Allocated/total GameServers plus headroom against the maxReplicas ceiling. Workspace-GLOBAL — one fleet serves every workspace, so the path workspace_id is only the auth anchor, never a data filter. Operator-only.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Successful Response
Live Agones fleet capacity (workspace-global).
headroom = remaining isolated-unit slots (max_replicas - allocated);
max_replicas/headroom are null when the ceiling isn't configured upstream.
The counts span the whole fleet (one fleet serves every workspace) — this is NOT
per-workspace. fleet/namespace echo which fleet was read.
GET /v1/{workspace_id}/sessions/fleet-status HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Successful Response
{
"fleet": "text",
"namespace": "text",
"ready": 1,
"allocated": 1,
"total": 1,
"max_replicas": 1,
"headroom": 1,
"by_state": {
"ANY_ADDITIONAL_PROPERTY": 1
}
}Inject an external event or guidance message into an active voice session. The agent incorporates it into its next response. Use event_type='guidance' for operator coaching, 'external_event' for system notifications.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Systemexternal_event (factual info) or guidance (instructional)
external_eventPossible values: Successful Response
Session not found.
Validation Error
Voice agent service unavailable.
POST /v1/{workspace_id}/sessions/{call_sid}/inject HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 66
{
"message": "text",
"sender": "System",
"event_type": "external_event"
}{
"status": "delivered",
"call_sid": "text"
}Start a web text session with a world model entity. Materializes the conversation and returns conversation_id for subsequent turns via POST /v1/{ws}/conversations/{id}/turns.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
World model entity UUID. Provide either entity_id or canonical_id.
World model canonical_id of the form 'source:resource_type:id' (e.g. 'charmhealth:Patient:67890'). The structural regex on CanonicalIdString blocks spaces, names, DOBs, and similar regulated content. Resolved against the SDP-projected world.entities_synced table; a freshly-created entity may not be visible yet if the projection is lagging. Provide either entity_id or canonical_id, not both.
^[A-Za-z0-9._-]+:[A-Za-z0-9._-]+:[A-Za-z0-9._-]+$Custom greeting. Agent auto-greets if omitted.
Successful Response
Service or entity not found.
Validation Error
Agent service unavailable.
POST /v1/{workspace_id}/sessions/start HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 166
{
"service_id": "123e4567-e89b-12d3-a456-426614174000",
"entity_id": "123e4567-e89b-12d3-a456-426614174000",
"canonical_id": "text",
"channel_kind": "text",
"greeting": "text"
}{
"conversation_id": "123e4567-e89b-12d3-a456-426614174000",
"session_status": "created",
"channel_kind": "text",
"entity_id": "123e4567-e89b-12d3-a456-426614174000",
"service_id": "123e4567-e89b-12d3-a456-426614174000",
"created_at": "text"
}Last updated
Was this helpful?