Release Callback Task

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

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

cURL

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

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

ReleaseCallbackTaskRequest

clear_assignee · boolean

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 released back to queue
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}/release' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "clear_assignee": true
}'

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"
}