---
title: "POST /v1/Workspaces/{WorkspaceSid}/Tasks"
method: POST
path: "/v1/Workspaces/{WorkspaceSid}/Tasks"
tags: ["TaskrouterV1Task"]
---

# POST /v1/Workspaces/{WorkspaceSid}/Tasks

`POST /v1/Workspaces/{WorkspaceSid}/Tasks`

## Path parameters

- `WorkspaceSid` string, required

## Response `201`

Created

- TaskrouterV1WorkspaceTask
  - `account_sid` string, nullable — 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` 'pending' | 'reserved' | 'assigned' | 'canceled' | 'completed' | 'wrapping' — The current status of the Task's assignment. Can be: `pending`, `reserved`, `assigned`, `canceled`, `wrapping`, or `completed`.
  - `attributes` string, nullable — 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, nullable — 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, nullable — 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, nullable — 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, nullable — 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, nullable — The reason the Task was canceled or completed, if applicable.
  - `sid` string, nullable — The unique string that we created to identify the Task resource.
  - `task_queue_sid` string, nullable — The SID of the TaskQueue.
  - `task_queue_friendly_name` string, nullable — The friendly name of the TaskQueue.
  - `task_channel_sid` string, nullable — The SID of the TaskChannel.
  - `task_channel_unique_name` string, nullable — 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, nullable — The SID of the Workflow that is controlling the Task.
  - `workflow_friendly_name` string, nullable — The friendly name of the Workflow that is controlling the Task.
  - `workspace_sid` string, nullable — The SID of the Workspace that contains the Task.
  - `url` string, uri, nullable — The absolute URL of the Task resource.
  - `links` object, nullable — The URLs of related resources.
  - `virtual_start_time` string, date-time, nullable — 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, nullable — 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, nullable — A SID of a Worker, Queue, or Workflow to route a Task to

---

[API](https://skmtc.net/twilio/apis/taskrouter-v1.md) · [All operations](https://skmtc.net/twilio/apis/taskrouter-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/taskrouter-v1/versions/f431d2bc66ba/schema)