Users

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.

Like other objects in the system, users are referred to by numerical IDs. However, the special string identifier me can be used anywhere a user ID is accepted, to refer to the current authenticated user.

Users have the following fields:

Field Description
id 1234 Read-only. Globally unique ID of the user.
name 'Greg Sanchez' Read-only except when same user as requester. The user’s name.
email 'gsanchez@example.com' Read-only. The user’s email address.
photo { 'image_21x21': 'https://...', ... } Read-only. A map of the user’s profile photo in various sizes, or null if no photo is set. Sizes provided are 21, 27, 36, 60, and 128. Images are in PNG format.
workspaces [ { id: 14916, name: 'My Workspace' }, ... ] Read-only. Workspaces and organizations this user may access.

Note: The API will only return workspaces and organizations that also contain the authenticated user.

GET A SINGLE USER

GET    /users/me

Returns the full user record for the currently authenticated user.


GET    /users/user-id

Returns the full user record for the single user with the provided ID.

Parameter Description
user 14641 me sashimi@asana.com Required: An identifier for the user. Can be one of an email address, the globally unique identifier for the user, or the keyword me to indicate the current user making the request.
# Request
curl -H "Authorization: Bearer <personal_access_token>" \
https://app.asana.com/api/1.0/users/5678

# Response
HTTP/1.1 200
{
  "data": {
    "workspaces": [
      {
        "id": 1337,
        "name": "My Favorite Workspace"
      },
      "~..."
    ],
    "id": 5678,
    "name": "Greg Sanchez",
    "email": "gsanchez@example.com"
  }
}

GET ALL USERS

GET    /workspaces/workspace-id/users

Returns the user records for all users in the specified workspace or organization.

Results are sorted alphabetically by user names.

Parameter Description
workspace 1331 Required: The workspace in which to get users.
# Request
curl -H "Authorization: Bearer <personal_access_token>" \
https://app.asana.com/api/1.0/workspaces/1337/users

# Response
HTTP/1.1 200
{
  "data": [
    {
      "id": 5678,
      "name": "Greg Sanchez"
    }
  ]
}

GET    /users

Returns the user records for all users in all workspaces and organizations accessible to the authenticated user. Accepts an optional workspace ID parameter.

Results are sorted by user ID.

Parameter Description
workspace 1331 The workspace or organization to filter users on.

Show a single user.

# Request
curl -H "Authorization: Bearer <personal_access_token>" \
https://app.asana.com/api/1.0/users/5678

# Response
HTTP/1.1 200
{
  "data": {
    "workspaces": [
      {
        "id": 1337,
        "name": "My Favorite Workspace"
      },
      "~..."
    ],
    "id": 5678,
    "name": "Greg Sanchez",
    "email": "gsanchez@example.com"
  }
}

Show names and emails of all users in all workspaces and organizations you’re a member of.

# Request
curl -H "Authorization: Bearer <personal_access_token>" \
https://app.asana.com/api/1.0/users?opt_fields=name,email

# Response
HTTP/1.1 200
{
  "data": [
    {
      "id": 1234,
      "name": "Tim Bizarro",
      "email": "tbizarro@example.com"
    },
    {
      "id": 5678,
      "name": "Greg Sanchez",
      "email": "gsanchez@example.com"
    },
    "~..."
  ]
}