Notification Targets

What Are Notification Targets?

A notification target attaches a notification channel to a scope (organization or project). Notifications for that scope are delivered to the attached channel.

Attaching a Target

POST /notification-configs/{id}/targets
{
  "scope_type": "project",
  "scope_id": "project-uuid"
}

Field	Type	Required	Description
scope_type	string	Yes	org or project
scope_id	UUID	Yes	The target resource ID

Scope Requirements

Scope Type	Requirement
org	Must match the caller’s org; requires org admin
project	Caller must have admin access to the project

Listing Targets

GET /notification-configs/{id}/targets

Returns all scope attachments for the notification channel.

Removing a Target

DELETE /notification-configs/{id}/targets/{targetId}

Requires the same permissions as creating a target (admin or creator + scope admin).

Idempotency

Attaching the same target twice returns 409 Conflict. Each scope can only be attached once per notification channel.

Related

• Notification Channels — Creating and testing channels
• User Preferences — Personal notification settings