Programmatically create a Twilio Flex Task, assign worker skills, and accept a reservation via the TaskRouter REST API
domain: twilio.com/docs/flex/routing/api · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate all requests with Twilio Account SID and Auth Token using HTTP Basic Auth against the base URL https://taskrouter.twilio.com/v1
POST to /Workspaces/{WorkspaceSid}/Tasks with a JSON attributes body and a WorkflowSid to create the task and trigger routing
Retrieve available workers via GET /Workspaces/{WorkspaceSid}/Workers?Available=true&TaskQueueSid={queueSid} to confirm skill-matched agents exist
Update a Worker's activity to 'Available' if needed via POST /Workspaces/{WorkspaceSid}/Workers/{WorkerSid} with ActivitySid
Poll GET /Workspaces/{WorkspaceSid}/Tasks/{TaskSid}/Reservations to detect when a reservation is created for a worker
Accept or reject the reservation via POST /Workspaces/{WorkspaceSid}/Tasks/{TaskSid}/Reservations/{ReservationSid} with ReservationStatus=accepted
Known gotchas
Task assignments are driven by the Workflow's filter expressions evaluated against task attributes — a mismatch between attribute key names in the task body and the filter expression silently drops tasks into a default queue or lets them time out
Worker capacity is controlled by TaskChannel configuration; if a channel's max capacity is 1 and the worker has an active task, no new reservations are created even when the worker is 'Available'
Reservation accept must come within the reservation timeout window (configurable per Workflow, default 120s); missed reservations move to the next eligible worker and cannot be reclaimed
Give your agent this knowledge — and 15,600+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?