Memberships
Retrieve a list of all organizations the user is a member of
Provide the token that is returned upon login
Limits the number of results to return
10Order in which to retrieve the results
falsePagination token that keeps of track of the current position in the list
The status of user's membership on the organization.
OK
Request validation failed
GET /me/memberships HTTP/1.1
Host:
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"nextPageToken": "text",
"results": [
{
"organization": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"slug": "text",
"avatarUrl": "text",
"status": "active",
"statusReason": "text",
"pendingMemberCount": 1,
"activeMemberCount": 1,
"owner": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2025-11-27T07:15:47.571Z",
"updatedAt": "2025-11-27T07:15:47.571Z",
"managedBy": [
{
"Type": "text",
"ID": "text"
}
],
"verified": true
},
"status": "banned",
"createdAt": "2025-11-27T07:15:47.571Z",
"updatedAt": "2025-11-27T07:15:47.571Z",
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
],
"requiredSsoAuth": true,
"requiredMfaAuth": true,
"attributes": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
]
}Retrieve a single organization membership object.
Provide the token that is returned upon login
The organization ID
OK
Resource not found
GET /me/memberships/{organizationId} HTTP/1.1
Host:
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"organization": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"slug": "text",
"avatarUrl": "text",
"status": "active",
"statusReason": "text",
"pendingMemberCount": 1,
"activeMemberCount": 1,
"owner": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2025-11-27T07:15:47.571Z",
"updatedAt": "2025-11-27T07:15:47.571Z",
"managedBy": [
{
"Type": "text",
"ID": "text"
}
],
"verified": true
},
"status": "banned",
"createdAt": "2025-11-27T07:15:47.571Z",
"updatedAt": "2025-11-27T07:15:47.571Z",
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
],
"requiredSsoAuth": true,
"requiredMfaAuth": true,
"attributes": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}Accept a pending invitation to join the organization.
Provide the token that is returned upon login
The organization ID
OK
Resource not found
The HTTP 409 Conflict response status code indicates a request conflict with current state of the target resource.
POST /me/memberships/{organizationId} HTTP/1.1
Host:
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"organization": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"slug": "text",
"avatarUrl": "text",
"status": "active",
"statusReason": "text",
"pendingMemberCount": 1,
"activeMemberCount": 1,
"owner": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2025-11-27T07:15:47.571Z",
"updatedAt": "2025-11-27T07:15:47.571Z",
"managedBy": [
{
"Type": "text",
"ID": "text"
}
],
"verified": true
},
"status": "banned",
"createdAt": "2025-11-27T07:15:47.571Z",
"updatedAt": "2025-11-27T07:15:47.571Z",
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
],
"requiredSsoAuth": true,
"requiredMfaAuth": true,
"attributes": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}Remove the membership from the organization for the current user
Provide the token that is returned upon login
The organization ID
OK
Resource not found
DELETE /me/memberships/{organizationId} HTTP/1.1
Host:
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Last updated
Was this helpful?

