Memberships
Retrieve a list of all organizations the user is a member of
Authorizations
Query parameters
limitinteger · min: 1 · max: 100OptionalDefault:
Limits the number of results to return
10
reversebooleanOptionalDefault:
Order in which to retrieve the results
false
pageTokenstringOptional
Pagination token that keeps of track of the current position in the list
statusstring · enumOptionalPossible values:
The status of user's membership on the organization.
Responses
200
OK
application/json
Responseall of
and
422
Request validation failed
application/json
get
GET /me/memberships HTTP/1.1
Host:
Authorization: Bearer jwt
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-06-30T19:51:14.196Z",
"updatedAt": "2025-06-30T19:51:14.196Z",
"managedBy": [
{
"Type": "text",
"ID": "text"
}
],
"verified": true
},
"status": "banned",
"createdAt": "2025-06-30T19:51:14.196Z",
"updatedAt": "2025-06-30T19:51:14.196Z",
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
],
"requiredSsoAuth": true,
"requiredMfaAuth": true
}
]
}
Retrieve a single organization membership object.
Authorizations
Path parameters
organizationIdstringRequired
The organization ID
Responses
200
OK
application/json
404
Resource not found
application/json
get
GET /me/memberships/{organizationId} HTTP/1.1
Host:
Authorization: Bearer jwt
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-06-30T19:51:14.196Z",
"updatedAt": "2025-06-30T19:51:14.196Z",
"managedBy": [
{
"Type": "text",
"ID": "text"
}
],
"verified": true
},
"status": "banned",
"createdAt": "2025-06-30T19:51:14.196Z",
"updatedAt": "2025-06-30T19:51:14.196Z",
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
],
"requiredSsoAuth": true,
"requiredMfaAuth": true
}
Accept a pending invitation to join the organization.
Authorizations
Path parameters
organizationIdstringRequired
The organization ID
Responses
200
OK
application/json
404
Resource not found
application/json
409
The HTTP 409 Conflict response status code indicates a request conflict with current state of the target resource.
application/json
post
POST /me/memberships/{organizationId} HTTP/1.1
Host:
Authorization: Bearer jwt
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-06-30T19:51:14.196Z",
"updatedAt": "2025-06-30T19:51:14.196Z",
"managedBy": [
{
"Type": "text",
"ID": "text"
}
],
"verified": true
},
"status": "banned",
"createdAt": "2025-06-30T19:51:14.196Z",
"updatedAt": "2025-06-30T19:51:14.196Z",
"roleRefs": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "organization",
"workspaces": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
],
"requiredSsoAuth": true,
"requiredMfaAuth": true
}
Remove the membership from the organization for the current user
Authorizations
Path parameters
organizationIdstringRequired
The organization ID
Responses
204
OK
404
Resource not found
application/json
delete
DELETE /me/memberships/{organizationId} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
No content
Last updated
Was this helpful?