Asana API

Getting access, Developing, Testing

Back to Asana

Get A User S Favorites

Returns all of a user's favorites in the given workspace, of the given type. Results are given in order (The same order as Asana's sidebar).


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. resource_type: type: string enum: - portfolio - project - tag - task - user - project_template default: project description: The resource type of favorites to be returned. workspace: type: string description: The workspace in which to get favorites. required: - user_gid - resource_type - workspace title: Parameters


type: object properties: data: 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 object. type: string example: Bug Task