Operators
Live dashboard with operator status counts, active escalation queue, and today's escalation statistics.
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}/operators/dashboard HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Successful Response
{
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"operators": {
"total": 1,
"online": 1,
"busy": 1,
"offline": 1
},
"active_escalations": 1,
"escalations_today": {
"requested": 0,
"connected": 0,
"completed": 0,
"avg_wait_seconds": 1,
"avg_handle_time_seconds": 1
},
"recent_escalations": [
{
"call_entity_id": "123e4567-e89b-12d3-a456-426614174000",
"call_sid": "text",
"escalation_id": "text",
"status": "text",
"trigger": "text",
"trigger_source": "text",
"concept": "text",
"operator_type": "clinical",
"regulatory_basis": "text",
"immediate": true,
"risk_score": 1,
"requested_at": "text",
"connected_at": "text",
"wait_seconds": 1,
"operator_entity_id": "123e4567-e89b-12d3-a456-426614174000",
"caller_id": "text",
"direction": "inbound",
"phone_number": "text",
"started_at": "text"
}
]
}Aggregate performance across all operators with per-operator breakdown.
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}/operators/performance HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Successful Response
{
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"total_operators": 1,
"online": 1,
"busy": 1,
"offline": 1,
"total_escalations_handled": 1,
"avg_handle_time_seconds": 1,
"operators": [
{
"operator_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"status": "online",
"total_escalations_handled": 1,
"avg_handle_time_seconds": 1,
"last_call_at": "text"
}
]
}List calls with active escalations (status: requested or connected).
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
50Successful Response
Validation Error
GET /v1/{workspace_id}/operators/escalations/active HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"call_entity_id": "123e4567-e89b-12d3-a456-426614174000",
"call_sid": "text",
"escalation_id": "text",
"status": "text",
"trigger": "text",
"trigger_source": "text",
"concept": "text",
"operator_type": "clinical",
"regulatory_basis": "text",
"immediate": true,
"risk_score": 1,
"requested_at": "text",
"connected_at": "text",
"wait_seconds": 1,
"operator_entity_id": "123e4567-e89b-12d3-a456-426614174000",
"caller_id": "text",
"direction": "inbound",
"phone_number": "text",
"started_at": "text"
}
],
"has_more": true,
"continuation_token": null
}Aggregated escalation statistics over a time period.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Time period: day, week, or month.
dayPossible values: Grouping dimension: status, trigger, or operator.
statusPossible values: Successful Response
Validation Error
GET /v1/{workspace_id}/operators/escalations/stats HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"period": "text",
"group_by": "text",
"buckets": [
{
"key": "text",
"count": 1
}
],
"total": 1
}List escalation lifecycle events for a workspace.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
50Successful Response
Validation Error
GET /v1/{workspace_id}/operators/escalations HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"event_type": "text",
"data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"source": "text",
"confidence": 1,
"ingested_at": "2026-01-01T00:00:00.000Z",
"created_at": "2026-01-01T00:00:00.000Z"
}
],
"has_more": true,
"continuation_token": null
}Query audit events (operator actions) for a workspace.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
50Filter by operator entity UUID.
Filter by exact operator audit event type.
Successful Response
Validation Error
GET /v1/{workspace_id}/operators/audit-log HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"event_type": "text",
"data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"source": "text",
"ingested_at": "2026-01-01T00:00:00.000Z",
"created_at": "2026-01-01T00:00:00.000Z"
}
],
"has_more": true,
"continuation_token": null
}Per-speaker transcript segments from operator takeover sessions.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Successful Response
Call not found.
Validation Error
GET /v1/{workspace_id}/operators/calls/{call_sid}/transcript HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"call_entity_id": "123e4567-e89b-12d3-a456-426614174000",
"call_sid": "text",
"total_segments": 1,
"segments": [
{
"speaker_role": "text",
"transcript": "text",
"timestamp": "text",
"escalation_id": "text",
"confidence": 1
}
]
}Active calls ranked by operator priority: risk, wait time, emotion, loops, and safety concerns.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Successful Response
Rate limit exceeded.
GET /v1/{workspace_id}/operators/queue HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"queue": [
{
"call_sid": "text",
"caller_id": "",
"caller_phone": "text",
"service_id": "",
"service_name": "text",
"direction": "inbound",
"data_quality_flags": [
"text"
],
"started_at": "2026-01-01T00:00:00.000Z",
"priority_score": 1,
"priority_reasons": [
"high_risk"
],
"wait_seconds": 0,
"risk_score": 1,
"risk_level": "low",
"current_emotion": "text",
"current_valence": 1,
"current_state": "",
"turn_count": 0,
"escalation_active": false,
"entity_name": "text",
"brief_context": "text"
}
],
"total_active": 1
}Structured briefing for an operator about to join a call. Template-rendered from call intelligence and entity context.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Request for operator briefing on a specific call.
Successful Response
Structured operator briefing for a call.
Invalid operator_id.
Validation Error
Rate limit exceeded.
POST /v1/{workspace_id}/operators/{operator_id}/briefing HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 19
{
"call_sid": "text"
}{
"call_sid": "text",
"operator_id": "123e4567-e89b-12d3-a456-426614174000",
"sections": [
{
"title": "text",
"content": "text"
}
],
"generated_at": "2026-01-01T00:00:00.000Z"
}Add operator to an active call's Twilio Conference.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Request to join an active call as operator.
takeoverPossible values: Successful Response
Confirmation of operator joining a call's conference.
Twilio participant call SID
Twilio conference SID
Operator mode: listen or takeover
World entity ID of the operator
Operator or active call not found.
Operator is already on a call.
Validation Error
Voice agent service unavailable.
POST /v1/{workspace_id}/operators/{operator_id}/join-call HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 37
{
"call_sid": "text",
"mode": "takeover"
}{
"participant_call_sid": "text",
"conference_sid": "text",
"mode": "listen",
"operator_entity_id": "123e4567-e89b-12d3-a456-426614174000"
}Remove operator from an active call's Twilio Conference.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Request to remove operator from an active call.
Successful Response
Operator or active call not found.
Validation Error
Voice agent service unavailable.
POST /v1/{workspace_id}/operators/{operator_id}/leave-call HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 19
{
"call_sid": "text"
}{
"success": true
}Switch between listen mode and takeover mode.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Request to toggle operator mode on an active call.
""Successful Response
New operator mode
Operator not found.
Validation Error
Voice agent service unavailable.
POST /v1/{workspace_id}/operators/{operator_id}/switch-mode HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 61
{
"call_sid": "text",
"participant_call_sid": "",
"mode": "listen"
}{
"mode": "listen"
}Inject operator guidance into an active call. The agent incorporates it into its next response.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Successful Response
Delivery status
Call SID the guidance was sent to
Operator or active call not found.
Validation Error
Voice agent service unavailable.
POST /v1/{workspace_id}/operators/{operator_id}/send-guidance HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36
{
"call_sid": "text",
"message": "text"
}{
"status": "delivered",
"call_sid": "text"
}Persist the outcome and notes from an operator's call intervention.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Request to record operator intervention wrap-up.
""Successful Response
Operator not found.
Validation Error
POST /v1/{workspace_id}/operators/{operator_id}/wrap-up HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 51
{
"call_sid": "text",
"outcome": "resolved",
"notes": ""
}{
"success": true
}List all operator entities for a workspace.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
50Successful Response
Validation Error
GET /v1/{workspace_id}/operators HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"email": "text",
"type": "clinical",
"skills": [
"text"
],
"connection_method": "browser",
"phone_number": "text",
"role": "operator",
"status": "online",
"last_status_change": "text",
"active_call_sid": "text",
"total_escalations_handled": 1,
"avg_handle_time_seconds": 1,
"last_call_at": "text",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
],
"has_more": true,
"continuation_token": null
}Create an operator entity with profile and initial offline status.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
clinicalPossible values: phonePossible values: operatorPossible values: Successful Response
Display name
Contact email
Operator specialization
Skill tags for routing
How the operator connects to calls
E.164 phone number for phone-based operators
Permission role
Current availability
ISO-8601 timestamp of last status transition
Call SID if currently on a call
Lifetime escalation count
Average escalation handle time in seconds
ISO-8601 timestamp of last call
When the operator was created
When the operator was last updated
Missing or invalid API key.
Insufficient permissions.
Validation Error
POST /v1/{workspace_id}/operators HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 144
{
"name": "text",
"email": "name@gmail.com",
"type": "clinical",
"skills": [
"text"
],
"connection_method": "phone",
"phone_number": "text",
"role": "operator"
}{
"id": "123e4567-e89b-12d3-a456-426614174000",
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"email": "text",
"type": "clinical",
"skills": [
"text"
],
"connection_method": "browser",
"phone_number": "text",
"role": "operator",
"status": "online",
"last_status_change": "text",
"active_call_sid": "text",
"total_escalations_handled": 1,
"avg_handle_time_seconds": 1,
"last_call_at": "text",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}Get operator entity with computed state (profile, availability, performance).
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Successful Response
Display name
Contact email
Operator specialization
Skill tags for routing
How the operator connects to calls
E.164 phone number for phone-based operators
Permission role
Current availability
ISO-8601 timestamp of last status transition
Call SID if currently on a call
Lifetime escalation count
Average escalation handle time in seconds
ISO-8601 timestamp of last call
When the operator was created
When the operator was last updated
Operator not found.
Validation Error
GET /v1/{workspace_id}/operators/{operator_id} HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"email": "text",
"type": "clinical",
"skills": [
"text"
],
"connection_method": "browser",
"phone_number": "text",
"role": "operator",
"status": "online",
"last_status_change": "text",
"active_call_sid": "text",
"total_escalations_handled": 1,
"avg_handle_time_seconds": 1,
"last_call_at": "text",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}Update operator profile fields or status. Each change writes a world event.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Successful Response
Display name
Contact email
Operator specialization
Skill tags for routing
How the operator connects to calls
E.164 phone number for phone-based operators
Permission role
Current availability
ISO-8601 timestamp of last status transition
Call SID if currently on a call
Lifetime escalation count
Average escalation handle time in seconds
ISO-8601 timestamp of last call
When the operator was created
When the operator was last updated
Operator not found.
Validation Error
PATCH /v1/{workspace_id}/operators/{operator_id} HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 164
{
"name": "text",
"email": "name@gmail.com",
"type": "clinical",
"skills": [
"text"
],
"connection_method": "browser",
"phone_number": "text",
"role": "operator",
"status": "online"
}{
"id": "123e4567-e89b-12d3-a456-426614174000",
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"email": "text",
"type": "clinical",
"skills": [
"text"
],
"connection_method": "browser",
"phone_number": "text",
"role": "operator",
"status": "online",
"last_status_change": "text",
"active_call_sid": "text",
"total_escalations_handled": 1,
"avg_handle_time_seconds": 1,
"last_call_at": "text",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}Last updated
Was this helpful?

