Skip to main content
Apply a topic proposal

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.

Path Parameters

id
string<uuid>
required

Body

application/json
topics
object[]

Edits to proposed topics. Omitted topics and fields are applied as proposed.

Maximum array length: 12
assignments
object[]

Split only. Moves alert groups between the proposed topics.

Maximum array length: 10000

Response

The topics were changed.

created_topic_ids
string<uuid>[]
required
deleted_topic_ids
string<uuid>[]
required
moved_alert_count
integer
required
Required range: x >= 0