Asana API

Getting access, Developing, Testing

Back to Asana

Get A User

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

Input

type: object properties: parameters: type: object properties: user_gid: type: string description: >- A string identifying a user. This can either be the string "me", an email, or the gid of a user. opt_pretty: type: boolean description: >- 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. opt_fields: type: array items: type: string description: >- Defines fields to return. Some requests return *compact* representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options. required: - user_gid title: Parameters

Output

type: object properties: data: type: object properties: gid: description: Globally unique identifier of the resource, as a string. type: string readOnly: true example: '12345' x-insert-after: false resource_type: description: The base type of this resource. type: string readOnly: true example: task x-insert-after: gid name: type: string description: '*Read-only except when same user as requester*. The user’s name.' example: Greg Sanchez email: type: string format: email readOnly: true description: The user's email address. example: [email protected] photo: type: object properties: image_21x21: type: string image_27x27: type: string image_36x36: type: string image_60x60: type: string image_128x128: type: string image_1024x1024: type: string workspaces: description: >- Workspaces and organizations this user may access. Note\: The API will only return workspaces and organizations that also contain the authenticated user. readOnly: true type: array items: type: object properties: gid: description: Globally unique identifier of the resource, as a string. type: string readOnly: true example: '12345' x-insert-after: false resource_type: description: The base type of this resource. type: string readOnly: true example: task x-insert-after: gid name: description: The name of the workspace. type: string example: My Company Workspace