Asana

Get a user task list

GET

/user_task_lists/{user_task_list_gid}

User Task Lists

Returns the full record for a user task list.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://app.asana.com/api/1.0/user_task_lists/'

Response Example

200 - Example 1

{
    "data": {
        "gid": "12345",
        "resource_type": "task",
        "name": "My Tasks in My Workspace",
        "owner": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Greg Sanchez"
        },
        "workspace": {
            "gid": "12345",
            "resource_type": "task",
            "name": "My Company Workspace"
        }
    }
}

Request

Path Params

user_task_list_gid

string

required

Responses

🟢200Successfully retrieved the user task list.

application/json

Body

data

object (UserTaskListCompact)

optional

A user task list represents the tasks assigned to a particular user. It provides API access to a user’s “My Tasks” view in Asana.

gid

string

read-onlyoptional

Globally unique identifier of the resource, as a string.

Example:

12345

resource_type

string

read-onlyoptional

The base type of this resource.

Example:

task

name

string

optional

The name of the user task list.

Example:

My Tasks in My Workspace

owner

object

read-onlyoptional

The owner of the user task list, i.e. the person whose My Tasks is represented by this resource.

workspace

object

read-onlyoptional

The workspace in which the user task list is located.

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Get a time period

Get a user's task list