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.
リソース | 概要 | Limit |
Workflows per Workspace | The maximum number of Workflows that you can create within an individual Workspace. | 1,000 |
Registered Workers per Workspace | The maximum number of registered Workers that you can create within an individual Workspace. | 15,000 |
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 | 概要 | Limit |
Workerの属性 | The maximum size of the JSON string used for defining Worker attributes. | 4096 bytes |
Taskの属性 | 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. For TaskRouter, Twilio's REST API 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 | 概要 | Rate Limit |
/Workspaces |
GET | List all Workspaces within a Project | 170 |
/Workspaces/WSxx |
削除 | Delete an individual Workspace | 5 |
/Activities |
GET | List all Activities within a Workspace | 150 |
|
GET |
Fetch all Tasks within a Workspace |
140
|
|
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 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 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 |
名前 | 概要 | 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) |
Updating the Waiting Voice Calls per TaskRouter Workflow Limit with Twilio CLI
The limit for the number of waiting voice calls is set on a per-workflow basis and can be updated through our REST API or by using Twilio CLI and the steps below.
Step 1: Find your TaskRouter Workflow SID
Find the workflow sid for the TaskRouter workflow that you are running into queue limit issues with, either through console or by running the following cli command.
Step 2: Find the Queue that matches your TaskRouter Workflow
Find the queue sid that matches your queue by running the following cli command. The friendlyName
for the queue you are looking for will be the workflow sid you grabbed in step 1.
Step 3: Update the maxSize of your Queue
Update the max size of the queue using the following cli command. The max-size
property can be an integer between 0 and 5000.
ヘルプが必要ですか?
誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。