Back to AsanaGet 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