Create rule - Timbal

curl --request POST \ --url https://api.timbal.ai/orgs/{org_id}/projects/{project_id}/notifications/rules \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "Deployment failures", "event_type": "project.deployment.failed", "cooldown_seconds": 3600, "channel": { "type": "email", "config": { "to": "oncall@example.com" } } } '

Authorizations

Authorization

string

header

required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id

string

required

project_id

string

required

Body

application/json

Body for POST org-wide or project-scoped notification rules (same shape).

channel

object

required

Channel: inline type + config, or reuse with { "id": <channel id> } (same org).

Show child attributes

event_type

enum<string>

required

Available options:

org.credits.usage,

project.deployment.failed,

project.deployment.running

name

string

required

condition

object | null

cooldown_seconds

integer<int32>

Response

Rule and channel link created

channel_action

enum<string>

required

How the rule was wired to NotificationChannels for this create call.

Available options:

linked,

reused,

created

channel_id

integer<int64>

required

integer<int64>

required