Skip to main content
PATCH
Update a team

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

If-Match
string | null

The team's current ETag, required to guard against a concurrent update.

x-tenant-id
string
required

The organization ID the request is scoped to.

Path Parameters

team_id
string
required

Body

application/json
name
string | null

New team name. Omit to leave unchanged.

default_member_role
enum<string> | null

New default member role. Omit to leave unchanged.

Available options:
editor,
viewer

Response

Successful Response

A team groups organization members for scoped access to SELECT resources.

id
string
required
read-only

The unique identifier of the team.

name
string
required

The name of the team.

is_all_users
boolean
required
read-only

Whether this team automatically includes every organization member. System-managed; not settable via the API.

default_member_role
enum<string>
required

Default role for members added to this team.

Available options:
editor,
viewer
create_time
string
required
read-only

When the team was created — RFC 3339 UTC, e.g. 2026-06-05T10:30:00Z.

update_time
string
required
read-only

When the team was last updated — RFC 3339 UTC.

etag
string
required
read-only

Opaque strong ETag for optimistic concurrency.