Skip to content

List runbooks

GET
/runbooks

Alert-triggered or manual runbook definition. Each runbook belongs to an organisation and defines a sequence of actions executed on enrolled agents.

pagination[page]
integer
pagination[pageSize]
integer
filters

Strapi REST filter syntax

object
sort
string
populate
string

OK

object
data
Array
object
name
required
string
>= 1 characters <= 120 characters
description
string
trigger_type
required
string
Allowed values: manual alert
trigger_condition

Alert filter condition, e.g. {metric: ‘cpu_percent’, operator: ’>’, threshold: 90}. Relevant only when trigger_type=alert.

actions
required

Ordered array of actions: [{type: string, params: {}}]. Supported types: restart_service, clear_disk_space, kill_process, run_approved_script.

confirmation_required
boolean
cooldown_minutes

Minimum minutes between executions of this runbook for a given organisation.

integer
is_active
boolean
last_triggered_at
string format: date-time
alert_name

Alertmanager alertname label that triggers this runbook (e.g. HighErrorRate). Leave blank to disable alert-based triggering.

string
<= 120 characters
auto_trigger

When true, receiving an Alertmanager alert matching alert_name will automatically log this runbook as triggered.

boolean
organisation
One of:

DocumentId reference to api::organisation.organisation

string
version

Version number — incremented by createVersion action.

integer
parent_version_id

DocumentId of the runbook this version was forked from (null for the root version).

string
is_draft

Draft flag — set to true when created via createVersion until promoted.

boolean
version_notes

Human-readable notes describing what changed in this version.

string
documentId
string
id
integer
createdAt
string format: date-time
updatedAt
string format: date-time
publishedAt
string format: date-time
nullable
meta
object
pagination
object
page
integer
pageSize
integer
pageCount
integer
total
integer

Missing or invalid authentication

Not authorized (tenant scope or capability)