Sign in
Team memberships

Get team memberships

<b>Required scope: </b><code>team_memberships:read</code>

Returns compact team membership records.

get/team_memberships

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/team_memberships
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token, scopes: team_memberships:read)

Query parameters

teamstring

Globally unique identifier for the team.

userstring

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.

workspacestring

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

opt_fieldsstring[]

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Properties can include nested fields. To learn more, see the input/output options guide.

Response

Successfully retrieved the requested team memberships.

Example response

{
  "data": [
    {
      "gid": "12345",
      "resource_type": "team_membership",
      "user": {
        "gid": "12345",
        "resource_type": "user",
        "name": "Greg Sanchez"
      },
      "team": {
        "gid": "12345",
        "resource_type": "team",
        "name": "Marketing"
      }
    }
  ],
  "next_page": {
    "offset": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
    "path": "/tasks/12345/attachments?limit=2&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
    "uri": "https://app.asana.com/api/1.0/tasks/12345/attachments?limit=2&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.