Skip to content

Teams

A team is a sub-group inside a workspace — useful for separating regions, product lines, or client books.

Endpoints

GET    /api/v1/teams                  list
POST   /api/v1/teams                  create
PUT    /api/v1/teams/:id              update
DELETE /api/v1/teams/:id              delete
GET    /api/v1/teams/:id/members      list members
POST   /api/v1/teams/:id/invite       invite a member

Team fields

typescript
{
  user_id: ObjectId,             // creator
  name: string | null,
  owner: ObjectId | null,
  permissions: string[],         // capability tags
  data: object | null,           // free-form
}

Invitations

Inviting from a team uses the same workspace invitation flow under the hood — see Invitations. The invitation carries a team association so the new member lands inside the right scope.