Asana API

Getting access, Developing, Testing

Back to Asana

Add A User To A Workspace Or Organization

Add a user to a workspace or organization. The user can be referenced by their globally unique user ID or their email address. Returns the full user record for the invited user.


type: object properties: parameters: type: object properties: workspace_gid: type: string description: Globally unique identifier for the workspace or organization. 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: - workspace_gid title: Parameters data: type: object properties: data: type: object properties: user: description: >- A string identifying a user. This can either be the string "me", an email, or the gid of a user. type: string example: '12345' title: Data


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