Skip to main content
Create a shared team

Authorizations

Authorization
string
header
required

Personal API key sent as a bearer token, together with X-Organization-Id. The key must have at least the access level the endpoint requires (read, write or admin).

Headers

X-Organization-Id
string

The organization to act in. Required for personal API keys; list the organizations you can access with GET /v1/organizations.

Body

application/json
name
string
required
Required string length: 1 - 100
filter
object | null

The team filter. On update, omit to keep it, send null to clear it, or send a complete definition to replace it. A team without a filter matches no records.

user_ids
string[]
Maximum array length: 100
Required string length: 1 - 255

Response

The created team.

id
string<uuid>
required
name
string
required
references
object[]
required
filter
any
required

A saved team filter, returned as stored; it may be null or no longer valid. To replace it, send a filter in the shape the team create and update requests accept.

created_at
string<date-time>
required
updated_at
string<date-time>
required