Skip to main content
Create a shared team

Authorizations

Authorization
string
header
required

Personal API key. Send X-Organization-Id. The required cumulative level is listed in x-watchdog-permission.

Headers

X-Organization-Id
string

Required for personal API keys. Target one organization you have access to. Migrated keys may omit it to use their original organization. For Clerk sessions, it must match the active organization.

Body

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

Omit to preserve the filter on PATCH, send null to clear it, or supply a complete version-1 definition to replace it. No saved filter matches no records.

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

Response

Created shared team.

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

Saved subscription filter JSON, shared by teams and personal notification sources. Teams return it verbatim, including null or invalid legacy definitions; notification sources include only usable filters. Use TeamFilterDefinition to author a replacement.

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