Get team memberships

GET

/team_memberships

Returns compact team membership records.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://app.asana.com/api/1.0/team_memberships'

Response Example

200 - Example 1

{
    "data": [
        {
            "gid": "12345",
            "resource_type": "task",
            "is_guest": false,
            "team": {
                "gid": "12345",
                "resource_type": "task",
                "name": "Marketing"
            },
            "user": {
                "gid": "12345",
                "resource_type": "task",
                "name": "Greg Sanchez"
            }
        }
    ]
}

Request

Query Params

team

string

optional

Globally unique identifier for the team.

Example:

159874

user

string

optional

A string identifying a user. This can either be the string "me", an email, or the gid of a user. This parameter must be used with the workspace parameter.

Example:

512241

workspace

string

optional

Globally unique identifier for the workspace. This parameter must be used with the user parameter.

Example:

31326

Responses

🟢200Successfully retrieved the requested team memberships.

application/json

Body

data

array[object (TeamMembershipCompact) {5}]

optional

gid

string

read-onlyoptional

Globally unique identifier of the resource, as a string.

Example:

12345

resource_type

string

read-onlyoptional

The base type of this resource.

Example:

task

is_guest

boolean

optional

Describes if the user is a guest in the team.

Example:

false

team

object

TeamCompact

optional

A team is used to group related projects and people together within an organization. Each project in an organization is associated with a team.

user

object

UserCompact

optional

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

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Modified at 2022-09-13 02:00:32

Create a tag in a workspace

Get a team membership