Claim Callback Task

Tenant or admin workflow endpoint for operator queues, callback tasks, supervisor actions, and follow-up processing.

POST /api/v1/callback-tasks/{id}/claim

cURL

curl --request POST \
  --url 'https://api.voice.stateset.com/api/v1/callback-tasks/{id}/claim' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "operator": "string"
}'

200

{
  "acknowledged_at": "2024-01-15T10:40:00Z",
  "acknowledged_by": "[e-mail]",
  "agent_name": "Support Agent",
  "assigned_to": "[e-mail]",
  "call_sid": "CA1234567890abcdef1234567890abcdef",
  "claimed_at": "2024-01-15T10:33:15Z",
  "completed_at": "2024-01-15T10:45:00Z",
  "created_at": "2024-01-15T10:30:00Z",
  "created_by": "dashboard",
  "customer_phone": "[phone]",
  "dispatch_attempt_count": 1,
  "disposition": "human_follow_up_required",
  "due_at": "2024-01-15T18:00:00Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "last_dispatch_attempted_at": "2024-01-15T10:47:00Z",
  "last_dispatch_call_sid": "CA9876543210abcdef9876543210abcdef",
  "last_dispatch_status": "initiated",
  "last_sla_alert_due_at": "2024-01-15T10:45:00Z",
  "last_sla_alerted_at": "2024-01-15T10:46:10Z",
  "metadata": null,
  "notes": "Reach out after carrier update is confirmed.",
  "priority": 10,
  "queue_key": "escalations",
  "sla_due_at": "2024-01-15T10:45:00Z",
  "snooze_reason": "Waiting on carrier escalation before calling customer back.",
  "snoozed_until": "2024-01-15T12:00:00Z",
  "status": "open",
  "stream_sid": "MZ1234567890abcdef1234567890abcdef",
  "summary": "Customer requested a human follow-up about a delayed shipment.",
  "tenant_id": "tenant-123",
  "updated_at": "2024-01-15T10:32:22Z"
}

Tenant or admin workflow endpoint for operator queues, callback tasks, supervisor actions, and follow-up processing.

Path parameters

id · string (uuid) · required

Callback task UUID

Request body

ClaimCallbackTaskRequest

operator · string · required

Response

CallbackTask

acknowledged_at · string · required

acknowledged_by · string,null

agent_name · string,null

assigned_to · string,null

call_sid · string,null

claimed_at · string · required

completed_at · string · required

created_at · string · required

created_by · string,null

customer_phone · string,null

dispatch_attempt_count · integer (int32) · required

disposition · CallbackDisposition · required

due_at · string · required

id · string · required

last_dispatch_attempted_at · string · required

last_dispatch_call_sid · string,null

last_dispatch_status · string,null

last_sla_alert_due_at · string · required

last_sla_alerted_at · string · required

metadata · any · required

notes · string,null

priority · integer (int32) · required

queue_key · string,null

sla_due_at · string · required

snooze_reason · string,null

snoozed_until · string · required

status · CallbackTaskStatus · required

stream_sid · string,null

summary · string,null

tenant_id · string · required

updated_at · string · required

Status codes

Code	Meaning
200	Callback task claimed
400	Validation error
401	Unauthorized
404	Callback task not found
500	Internal server error
503	Database not configured

cURL

curl --request POST \
  --url 'https://api.voice.stateset.com/api/v1/callback-tasks/{id}/claim' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "operator": "string"
}'

200

{
  "acknowledged_at": "2024-01-15T10:40:00Z",
  "acknowledged_by": "[e-mail]",
  "agent_name": "Support Agent",
  "assigned_to": "[e-mail]",
  "call_sid": "CA1234567890abcdef1234567890abcdef",
  "claimed_at": "2024-01-15T10:33:15Z",
  "completed_at": "2024-01-15T10:45:00Z",
  "created_at": "2024-01-15T10:30:00Z",
  "created_by": "dashboard",
  "customer_phone": "[phone]",
  "dispatch_attempt_count": 1,
  "disposition": "human_follow_up_required",
  "due_at": "2024-01-15T18:00:00Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "last_dispatch_attempted_at": "2024-01-15T10:47:00Z",
  "last_dispatch_call_sid": "CA9876543210abcdef9876543210abcdef",
  "last_dispatch_status": "initiated",
  "last_sla_alert_due_at": "2024-01-15T10:45:00Z",
  "last_sla_alerted_at": "2024-01-15T10:46:10Z",
  "metadata": null,
  "notes": "Reach out after carrier update is confirmed.",
  "priority": 10,
  "queue_key": "escalations",
  "sla_due_at": "2024-01-15T10:45:00Z",
  "snooze_reason": "Waiting on carrier escalation before calling customer back.",
  "snoozed_until": "2024-01-15T12:00:00Z",
  "status": "open",
  "stream_sid": "MZ1234567890abcdef1234567890abcdef",
  "summary": "Customer requested a human follow-up about a delayed shipment.",
  "tenant_id": "tenant-123",
  "updated_at": "2024-01-15T10:32:22Z"
}