Get a user

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

Path Params
string
required

A string identifying a user. This can either be the string "me", an email, or the gid of a user.

Query Params
array of strings

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

opt_fields
boolean

Provides “pretty” output.
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

Responses

Response body
object
object

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

string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

Read-only except when same user as requester. The user’s name.

string

The user's email address.

object | null

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, 128, and 1024. All images are in PNG format, except for 1024 (which is in JPEG format).

array of objects

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

workspaces
object
string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

The name of the workspace.

Language
Credentials
OAuth2
Request
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.