Skip to main content
Create chart trigger

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspace_slug
string
required

URL-friendly workspace identifier

Example:

"acme"

dashboard_id
string<uuid>
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

chart_id
string<uuid>
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json
cron_spec
string
required

Cron expression that controls when the trigger runs.

trigger_type
enum<string>
required
Available options:
always,
has_results,
no_results,
value_threshold
name
string
Maximum string length: 120
enabled
boolean
filters
object
action_id
string

Action to execute when the trigger fires.

trigger_condition
object

Required for trigger types that need a condition, such as value_threshold.

Response

Created trigger

trigger_id
string<uuid>
Example:

"550e8400-e29b-41d4-a716-446655440000"

chart_id
string<uuid>
Example:

"550e8400-e29b-41d4-a716-446655440000"

action_id
string | null
name
string
cron_spec
string

Cron expression that controls when the trigger runs.

enabled
boolean
filters
object | null
trigger_type
enum<string>
Available options:
always,
has_results,
no_results,
value_threshold
trigger_condition
object | null
created_at
string<date-time>
Example:

"2024-01-15T10:30:00Z"

updated_at
string<date-time>
Example:

"2024-01-15T10:30:00Z"

Last modified on July 29, 2026