List Callback Tasks

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

GET /api/v1/callback-tasks

cURL

curl --request GET \
  --url 'https://api.voice.stateset.com/api/v1/callback-tasks' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY"

200

{
  "ok": true,
  "tenant": "acme-outdoors",
  "count": 2,
  "tasks": [
    {
      "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.

Query parameters

status · CallbackTaskStatus

disposition · CallbackDisposition

stream_sid · string

queue_key · string

overdue_only · boolean

limit · integer (int64)

offset · integer (int64)

Response

object

ok · boolean · required

tenant · string · required

Tenant id the listing is scoped to

count · integer · required

Number of tasks in this response

tasks · CallbackTask[] · required

Show 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	List callback workflow tasks
401	Unauthorized
500	Internal server error
503	Database not configured

cURL

curl --request GET \
  --url 'https://api.voice.stateset.com/api/v1/callback-tasks' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY"

200

{
  "ok": true,
  "tenant": "acme-outdoors",
  "count": 2,
  "tasks": [
    {
      "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"
    }
  ]
}