API

Teams

Team management and member roles

Teams (organizations) are the top-level container for properties, members, and billing.

Create Team

POST /teams

Creates a new team. The creating user becomes the owner.

Request body

FieldTypeRequiredDescription
namestringYesTeam display name
slugstringYesURL-safe identifier (must be unique)

Get Current Team

GET /team

Returns the current team's details and settings.

Update Team

PATCH /team

Update team name, settings, or branding.

Check Slug Availability

GET /teams/check-slug?slug=my-team

Check if a team slug is available before creating.

Update Member Role

PUT /team/role

Change a team member's role.

Request body

FieldTypeRequiredDescription
userIdstringYesThe user to update
rolestringYesNew role: owner, admin, or member