Teams

Last updated 24 days ago

Base path: /v1/teams · Auth: Bearer

Method	Path	Purpose
`GET`	`/v1/teams`	List teams
`POST`	`/v1/teams`	Create a team
`GET`	`/v1/teams/{teamId}`	Get a team
`PATCH`	`/v1/teams/{teamId}`	Update a team
`DELETE`	`/v1/teams/{teamId}`	Delete a team
`POST`	`/v1/teams/{teamId}/members`	Add members
`DELETE`	`/v1/teams/{teamId}/members/{userId}`	Remove a member

Query (`GET /v1/teams`)

Pagination plus status (active/inactive/deleted) and parent (UUID).

Field	Type	Required	Description
`name`	string (1–255)	✅	Team name
`parent`	UUID	–	Parent team
`initials`	string (≤10)	–	Short label
`avatar`	string (URI)	–	Avatar URL
`sid`	string	–	Custom short ID

All optional: name, parent, status (active/inactive/deleted), initials, avatar.

Field	Type	Required	Description
`members`	UUID[] (min. 1)	✅	Users to add

bash