Team Management
Retrieve a list of teams within the workspace, showcasing their members count and other details.
Limits the number of results to return
10
Pagination token that keeps of track of the current position in the list
Order in which to retrieve the results
false
Sort by field specified
OK
Workspace not found
GET /workspaces/{workspaceId}/teams HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
{
"results": [
{
"id": "text",
"workspaceId": "text",
"name": "text",
"description": "text",
"visibility": "text",
"accessibility": "text",
"activeMemberCount": 1,
"pendingMemberCount": 1,
"featuredMembers": [
{
"id": "text",
"type": "text"
}
],
"hideFromViews": true,
"createdAt": "2025-08-23T22:07:21.676Z",
"updatedAt": "2025-08-23T22:07:21.676Z"
}
],
"nextPageToken": "text",
"total": 1
}
Retrieve information about a specific team within the workspace, including its name, and other details.
OK
Team or workspace not found
GET /workspaces/{workspaceId}/teams/{teamId} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
{
"id": "text",
"workspaceId": "text",
"name": "text",
"description": "text",
"visibility": "text",
"accessibility": "text",
"activeMemberCount": 1,
"pendingMemberCount": 1,
"featuredMembers": [
{
"id": "text",
"type": "text"
}
],
"hideFromViews": true,
"createdAt": "2025-08-23T22:07:21.676Z",
"updatedAt": "2025-08-23T22:07:21.676Z"
}
Create a new team within the workspace, defining its name, and other relevant attributes.
Input for creating a new team.
false
Created
Workspace not found
Invalid request
POST /workspaces/{workspaceId}/teams HTTP/1.1
Host:
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 98
{
"name": "text",
"description": "text",
"hideFromViews": false,
"members": [
{
"id": "text",
"type": "text"
}
]
}
{
"id": "text",
"workspaceId": "text",
"name": "text",
"description": "text",
"visibility": "text",
"accessibility": "text",
"activeMemberCount": 1,
"pendingMemberCount": 1,
"featuredMembers": [
{
"id": "text",
"type": "text"
}
],
"hideFromViews": true,
"createdAt": "2025-08-23T22:07:21.676Z",
"updatedAt": "2025-08-23T22:07:21.676Z"
}
Modify the details of a specific team within the workspace, such as its name, or other attributes.
Input for updating a team's properties.
OK
Team or workspace not found
Invalid request
PATCH /workspaces/{workspaceId}/teams/{teamId} HTTP/1.1
Host:
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 57
{
"name": "text",
"description": "text",
"hideFromViews": true
}
{
"id": "text",
"workspaceId": "text",
"name": "text",
"description": "text",
"visibility": "text",
"accessibility": "text",
"activeMemberCount": 1,
"pendingMemberCount": 1,
"featuredMembers": [
{
"id": "text",
"type": "text"
}
],
"hideFromViews": true,
"createdAt": "2025-08-23T22:07:21.676Z",
"updatedAt": "2025-08-23T22:07:21.676Z"
}
Remove a specific team from the workspace, permanently deleting its profile and associated data.
Deleted
Team or workspace not found
DELETE /workspaces/{workspaceId}/teams/{teamId} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
No content
Retrieve a list of members within the team, showcasing their names and other details.
OK
Team or workspace not found
GET /workspaces/{workspaceId}/teams/{teamId}/members HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
{
"results": [
{
"id": "text",
"teamId": "text",
"type": "text",
"status": "text",
"createdAt": "2025-08-23T22:07:21.676Z",
"updatedAt": "2025-08-23T22:07:21.676Z"
}
]
}
Add a new member to the team.
Created
Team or workspace not found
User is already a member
Invalid request
POST /workspaces/{workspaceId}/teams/{teamId}/members HTTP/1.1
Host:
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 27
{
"id": "text",
"type": "user"
}
{
"id": "text",
"teamId": "text",
"type": "text",
"status": "text",
"createdAt": "2025-08-23T22:07:21.676Z",
"updatedAt": "2025-08-23T22:07:21.676Z"
}
Retrieve information about a specific member within the team, including their name and other details.
OK
Member, team or workspace not found
GET /workspaces/{workspaceId}/teams/{teamId}/members/user/{teamMemberUserID} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
{
"id": "text",
"teamId": "text",
"type": "text",
"status": "text",
"createdAt": "2025-08-23T22:07:21.676Z",
"updatedAt": "2025-08-23T22:07:21.676Z"
}
Remove a specific member from the team.
deleted
Member, team or workspace not found
DELETE /workspaces/{workspaceId}/teams/{teamId}/members/user/{teamMemberUserID} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
No content
Last updated
Was this helpful?