# Create task **POST /v1/Workspaces/{WorkspaceSid}/Tasks** ## Servers - https://taskrouter.twilio.com: https://taskrouter.twilio.com () ## Authentication methods - Account sid auth token ## Parameters ### Path parameters - **WorkspaceSid** (string) The SID of the Workspace that the new Task belongs to. ### Body: application/x-www-form-urlencoded (object) - **Timeout** (integer) The amount of time in seconds the new task can live before being assigned. Can be up to a maximum of 2 weeks (1,209,600 seconds). The default value is 24 hours (86,400 seconds). On timeout, the `task.canceled` event will fire with description `Task TTL Exceeded`. - **Priority** (integer) The priority to assign the new task and override the default. When supplied, the new Task will have this priority unless it matches a Workflow Target with a Priority set. When not supplied, the new Task will have the priority of the matching Workflow Target. Value can be 0 to 2^31^ (2,147,483,647). - **TaskChannel** (string) When MultiTasking is enabled, specify the TaskChannel by passing either its `unique_name` or `sid`. Default value is `default`. - **WorkflowSid** (string) The SID of the Workflow that you would like to handle routing for the new Task. If there is only one Workflow defined for the Workspace that you are posting the new task to, this parameter is optional. - **Attributes** (string) A JSON string with the attributes of the new task. This value is passed to the Workflow's `assignment_callback_url` when the Task is assigned to a Worker. For example: `{ "task_type": "call", "twilio_call_sid": "CAxxx", "customer_ticket_number": "12345" }`. - **VirtualStartTime** (string(date-time)) The virtual start time to assign the new task and override the default. When supplied, the new task will have this virtual start time. When not supplied, the new task will have the virtual start time equal to `date_created`. Value can't be in the future or before the year of 1900. - **RoutingTarget** (string) A SID of a Worker, Queue, or Workflow to route a Task to - **IgnoreCapacity** (string) A boolean that indicates if the Task should respect a Worker's capacity and availability during assignment. This field can only be used when the `RoutingTarget` field is set to a Worker SID. By setting `IgnoreCapacity` to a value of `true`, `1`, or `yes`, the Task will be routed to the Worker without respecting their capacity and availability. Any other value will enforce the Worker's capacity and availability. The default value of `IgnoreCapacity` is `true` when the `RoutingTarget` is set to a Worker SID. - **TaskQueueSid** (string) The SID of the TaskQueue in which the Task belongs ## Responses ### 201 Created #### Headers - **ETag** (string) - **X-Rate-Limit-Limit** (string) - **X-Rate-Limit-Remaining** (string) - **X-Rate-Limit-Config** (string) - **Access-Control-Allow-Origin** (string) Specify the origin(s) allowed to access the resource - **Access-Control-Allow-Methods** (string) Specify the HTTP methods allowed when accessing the resource - **Access-Control-Allow-Headers** (string) Specify the headers allowed when accessing the resource - **Access-Control-Allow-Credentials** (boolean) Indicates whether the browser should include credentials - **Access-Control-Expose-Headers** (string) Headers exposed to the client #### Body: application/json (object) - **account_sid** (string | null) The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Task resource. - **age** (integer) The number of seconds since the Task was created. - **assignment_status** (string) The current status of the Task's assignment. Can be: `pending`, `reserved`, `assigned`, `canceled`, `wrapping`, or `completed`. - **attributes** (string | null) The JSON string with custom attributes of the work. **Note** If this property has been assigned a value, it will only be displayed in FETCH action that returns a single resource. Otherwise, it will be null. - **addons** (string | null) An object that contains the [Add-on](https://www.twilio.com/docs/add-ons) data for all installed Add-ons. - **date_created** (string(date-time) | null) The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - **date_updated** (string(date-time) | null) The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - **task_queue_entered_date** (string(date-time) | null) The date and time in GMT when the Task entered the TaskQueue, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - **priority** (integer) The current priority score of the Task as assigned to a Worker by the workflow. Tasks with higher priority values will be assigned before Tasks with lower values. - **reason** (string | null) The reason the Task was canceled or completed, if applicable. - **sid** (string | null) The unique string that we created to identify the Task resource. - **task_queue_sid** (string | null) The SID of the TaskQueue. - **task_queue_friendly_name** (string | null) The friendly name of the TaskQueue. - **task_channel_sid** (string | null) The SID of the TaskChannel. - **task_channel_unique_name** (string | null) The unique name of the TaskChannel. - **timeout** (integer) The amount of time in seconds that the Task can live before being assigned. - **workflow_sid** (string | null) The SID of the Workflow that is controlling the Task. - **workflow_friendly_name** (string | null) The friendly name of the Workflow that is controlling the Task. - **workspace_sid** (string | null) The SID of the Workspace that contains the Task. - **url** (string(uri) | null) The absolute URL of the Task resource. - **links** (object(uri-map) | null) The URLs of related resources. - **virtual_start_time** (string(date-time) | null) The date and time in GMT indicating the ordering for routing of the Task specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - **ignore_capacity** (boolean | null) A boolean that indicates if the Task should respect a Worker's capacity and availability during assignment. This field can only be used when the `RoutingTarget` field is set to a Worker SID. By setting `IgnoreCapacity` to a value of `true`, `1`, or `yes`, the Task will be routed to the Worker without respecting their capacity and availability. Any other value will enforce the Worker's capacity and availability. The default value of `IgnoreCapacity` is `true` when the `RoutingTarget` is set to a Worker SID. - **routing_target** (string | null) A SID of a Worker, Queue, or Workflow to route a Task to [Powered by Bump.sh](https://bump.sh)