EaserixDocs
DevelopersAPI referenceAuth & accountsTeams

Update a team

Team workspaces only; team lead or org.teams.manage. Returns a message, not the team.

View as Markdown
PATCH
/v1/workspaces/{id}/teams/{tid}

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

id*string
tid*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/workspaces/string/teams/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "message": "string"}

Create a team

Team workspaces only; requires org.teams.manage (owner or admin) — the same permission as rename and delete. The creator becomes the team lead. Returns 200 (not 201) with member_count 1 and my_role lead.

Delete a team

Team workspaces only; team lead or org.teams.manage. Soft delete. The workspace's DEFAULT team cannot be deleted and answers 409 with `code: default_team`. Everyone who joins the workspace belongs to it, so deleting it dropped every roster row, left the team's content unreachable in the tools, and was then rebuilt empty by the next join — carrying only the owner and that joiner, leaving everyone else on no team until the service next converged. An admin tightening access wants to remove members, which is a different call. The default team goes when the workspace goes.