Menu

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

TaskRouter Resource Limits

Twilio TaskRouter has default limits on certain resources, configuration parameters, and endpoints. If you are running into these limits, please reach out to our support team. We're happy to help work with you to increase some of these limits or help optimize how you use TaskRouter.

Please note that Twilio Flex only supports a single TaskRouter Workspace within a Flex Project. While you may create additional Workspaces on a Flex Project, Twilio Flex will only recognise the TaskRouter Workspace provisioned upon Project creation.

Resource Description Limit
Workflows per Workspace The maximum number of Workflows that you can create within an individual Workspace. 1,000
Workers per Workspace The maximum number of Workers that you can create within an individual Workspace. 7,500
Activites per Workspace The maximum number of Activities you can create within an individual Workspace. 100
TaskQueues per Workspace The maximum number of TaskQueues you can create within an individual Workspace. 5,000
Tasks per Workspace

The maximum number of Tasks in any state that can exist on an individual Workspace. Please note that completed and cancelled tasks are removed after 15 minutes.

500,000
TaskChannels per Workspace The maximum number of TaskChannels you can create within an individual Workspace. This limit is inclusive of the default TaskChannel. 15
Workspaces per Project The maximum number of Workspaces that you can create on an individual non-Flex project. Please note that Twilio Flex only supports a single workspace. 5,000
Channel Capacity per Worker The maximum number of Tasks that can be assigned to a worker on a given TaskChannel. 50

The limits on JSON attributes include whitespace. You save a few bytes by using a JSON minifier and creating/updating the Resource through the REST API.

Configuration Description Limit
Worker Attributes The maximum size of the JSON string used for defining Worker attributes. 4096 bytes
Task Attributes The maximum size of the JSON string used for defining Task attributes. 4096 bytes
Workflow Configuration The maximum size of the JSON string used to define a Workflow. 16777215 bytes (1MB)
Task Timeout (Pending and Reserved Tasks) The maximum amount of time a Task can exist in a pending or reserved state before timing out (task.timeout) and being cancelled. 1209600 seconds (2 weeks)
Task Timeout (Assigned Tasks) The maximum amount of time a Task can stay assigned to a Worker before being deleted by the system (task.system-deleted). 86400 seconds (24 hours)
Max Reserved Workers The maximum number of Workers that can simultaneously be offered a reservation for a Task in a TaskQueue with Multi-Reservation enabled. 50

If a resource or method is not documented below, it is not rate limited. Twilio's REST API as a whole has a default limit of 100 max concurrent connections.

All endpoints below are prefixed by /Workspaces/WSxxx/, with the exception of the Workspace endpoints. Rate Limits are stated in requests per second.

Endpoint Method Description Rate Limit
/Workspaces GET List all Workspaces within a Project 170
/Workspaces/WSxx DELETE Delete an individual Workspace 5
/Activities GET List all Activities within a Workspace 150

/Tasks

GET

Fetch all Tasks within a Workspace

140

/Tasks
?EvaluateTaskAttributes=
"foo=='bar'"

GET

Fetch specific Tasks within a Workspace

30

/Tasks/WTxx POST Update an individual Task 50
/Tasks/WTxx/Reservations/WRxx POST Update an individual Reservation 70
/TaskChannels GET List all TaskChannels within a Workspace 10
/TaskChannels POST Create a new TaskChannel 1
/TaskChannels/TCxx DELETE Delete an individual TaskChannel 1
/TaskQueues GET List all TaskQueues within a Workspace 200
/TaskQueues POST Create a new TaskQueue 47
/TaskQueues/WQxx GET Fetch an individual TaskQueue 13
/TaskQueues/WQxx POST Update an individual TaskQueue 5
/TaskQueues/WQxx DELETE Delete an individual TaskQueue 5
/Workers GET List all Workers within a Workspace 240
/Workers/WKxx POST Update an individual Worker 60
/Workflows GET List all Workflows within a Workspace 10
/Workflows/WWxx POST Update an individual Workflow 10
Name Description Limit
Reservations per Task Number of times a Task can be reserved before being cancelled 1,000
Rejected Reservations Number of Reservations for a Task that can be rejected before the Task is cancelled 10
Worker Statistics Endpoint Cap Worker Statistics REST API endpoints are not accessible by default if you have over these many Workers in your Workspace. 100
Waiting Voice Calls per TaskRouter Workflow Every TaskRouter workflow that handles voice calls has a Programmable Voice queue under the hood. This refers to the default size of that queue. 100 (max 5000)
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.