Skip to main content
POST
Create a team

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organization_id
string
required

Body

application/json

The team configuration to create.

name
string
required

The name of the team.

is_all_users
boolean
required

Whether this is the special 'all users' team that automatically includes all organization members

default_member_role
enum<string>
default:editor

Default role assigned to new members when they are added to the team

Available options:
editor,
viewer

Response

Successful Response

Basic team information returned by public API.

id
string<uuid>
required

The unique identifier of the team

name
string
required

The name of the team

is_all_users
boolean
required

Whether this is the special 'all users' team that automatically includes all organization members

default_member_role
enum<string>
required

Default role assigned to new members when they are added to the team

Available options:
editor,
viewer
created_at
string<date-time>
required

When the team was created

updated_at
string<date-time>
required

When the team was last updated