# List task

**GET /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 with the Tasks to read.

### Query parameters
- **Priority** (integer)
  The priority value of the Tasks to read. Returns the list of all Tasks in the Workspace with the specified priority.
- **AssignmentStatus** (array[string])
  The `assignment_status` of the Tasks you want to read. Can be: `pending`, `reserved`, `assigned`, `canceled`, `wrapping`, or `completed`. Returns all Tasks in the Workspace with the specified `assignment_status`.
- **WorkflowSid** (string)
  The SID of the Workflow with the Tasks to read. Returns the Tasks controlled by the Workflow identified by this SID.
- **WorkflowName** (string)
  The friendly name of the Workflow with the Tasks to read. Returns the Tasks controlled by the Workflow identified by this friendly name.
- **TaskQueueSid** (string)
  The SID of the TaskQueue with the Tasks to read. Returns the Tasks waiting in the TaskQueue identified by this SID.
- **TaskQueueName** (string)
  The `friendly_name` of the TaskQueue with the Tasks to read. Returns the Tasks waiting in the TaskQueue identified by this friendly name.
- **EvaluateTaskAttributes** (string)
  The attributes of the Tasks to read. Returns the Tasks that match the attributes specified in this parameter.
- **RoutingTarget** (string)
  A SID of a Worker, Queue, or Workflow to route a Task to
- **Ordering** (string)
  How to order the returned Task resources. By default, Tasks are sorted by ascending DateCreated. This value is specified as: `Attribute:Order`, where `Attribute` can be either `DateCreated`, `Priority`, or `VirtualStartTime` and `Order` can be either `asc` or `desc`. For example, `Priority:desc` returns Tasks ordered in descending order of their Priority. Pairings of sort orders can be specified in a comma-separated list such as `Priority:desc,DateCreated:asc`, which returns the Tasks in descending Priority order and ascending DateCreated Order. The only ordering pairing not allowed is DateCreated and VirtualStartTime.
- **HasAddons** (boolean)
  Whether to read Tasks with Add-ons. If `true`, returns only Tasks with Add-ons. If `false`, returns only Tasks without Add-ons.
- **PageSize** (integer(int64))
  How many resources to return in each list page. The default is 50, and the maximum is 1000.
- **Page** (integer)
  The page index. This value is simply for client state.
- **PageToken** (string)
  The page token. This is provided by the API.


## Responses
### 200
OK
#### 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)
- **tasks** (array[object])

- **meta** (object)



[Powered by Bump.sh](https://bump.sh)