Ctrl+K

List my memberships

List my memberships#

Description#

Return a paginated collection of the workspace memberships held by the authenticated user. Results can be filtered by workspace or organization, and filtering composes with pagination: the filter is applied first and the matching memberships are then paged. Follow the @nextLink in the response to retrieve subsequent pages.

GET /me/memberships

Required OAuth Scopes

No OAuth scopes are required to use this endpoint.

Parameters#

Parameter

In

Type

Required

Description

X-Version

header

string

true

Version of the API (2026-09-01.grc.preview)

$maxpagesize

query

integer(int32)

false

Maximum number of items to return in a single page. The service applies a default and a maximum; requests above the maximum are clamped.

$next

query

string

false

Opaque cursor identifying the next page of results, taken from the previous page. Omit on the first request.

$filter

query

string

false

Filter expression restricting the collection, of the form field <op> value. Comparison operators are eq, in, and contains, composed with the logical connectives and, or, and not (negation is expressed as not (field eq value) — there is no ne). The set of filterable fields and supported operators varies per resource. Example: significance eq 'key'.

Filter Options#

Available logical operators: and

Name

Predicates Supported

organization.id

eq

organization.name

eq, contains

workspace.id

eq

workspace.name

eq, contains

Code Samples#

curl -X GET https://api.app.wdesk.com/me/memberships \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer {access-token}' \
    -H 'X-Version: 2026-09-01.grc.preview'

http GET https://api.app.wdesk.com/me/memberships \
    X-Version:2026-09-01.grc.preview \
    Accept:application/json \
    Authorization:"Bearer {access-token}"

wget --method=GET "https://api.app.wdesk.com/me/memberships" \
    --output-document - \
    --header 'Accept: application/json' \
    --header 'Authorization: Bearer {access-token}' \
    --header 'X-Version: 2026-09-01.grc.preview'

import requests

headers = {
  'X-Version': '2026-09-01.grc.preview',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api.app.wdesk.com/me/memberships', headers = headers)

print(r.json())

Returns#

200 - A paginated collection of the authenticated user’s workspace memberships.#

A paginated collection of the workspace memberships held by the authenticated user.

400 - The request was invalid.#

Error response indicating the service could not process the request.

401 - Authentication is missing or invalid.#

Error response indicating the service could not process the request.

403 - The caller is not permitted to access this resource.#

Error response indicating the service could not process the request.

429 - The rate limit has been exceeded.#

Error response indicating the service could not process the request.

500 - An unexpected error occurred.#

Error response indicating the service could not process the request.

Example Responses#

{
  "data": [
    {
      "id": "wm_0a8932e5302a4494950b9a4a2d46905c",
      "organization": {
        "id": "f4f8a26c-e062-4303-8460-bc57312a269a",
        "name": "APIs Testing"
      },
      "workspace": {
        "id": "QWNjb3VudB8xMTY5MjAyNTI4",
        "name": "APIs Admin Testing Workspace"
      }
    }
  ]
}

{
  "code": "invalidFilter",
  "message": "The $filter value could not be parsed.",
  "target": "$filter"
}

{
  "code": "unauthenticated",
  "message": "Authentication credentials were missing or invalid."
}

{
  "code": "permissionDenied",
  "message": "You do not have permission to access this resource."
}

{
  "code": "rateLimitExceeded",
  "message": "Rate limit exceeded. Retry after the period indicated in the response headers."
}

{
  "code": "internalError",
  "message": "An unexpected error occurred. Please try again later."
}