Skip to content
Sencai Logo Sencai Logo Sencai Docs

List runbook-executions

GET
/runbook-executions

Single execution record for a runbook. Tracks lifecycle from pending approval through execution to completion or failure.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
pagination[page]
integer
pagination[pageSize]
integer
filters

Strapi REST filter syntax

object
sort
string
populate
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

object
data
Array
object
runbook
One of:

DocumentId reference to api::runbook.runbook

string
organisation
One of:

DocumentId reference to api::organisation.organisation

string
triggered_by
required
string
Allowed values: alert manual
status
required
string
Allowed values: pending dry_run running completed failed cancelled
result

Execution result payload from agent. Array of {action, success, output, error}.

dry_run
boolean
approved_at
string format: date-time
expires_at

Approval TTL — execution is auto-cancelled if not approved by this time (now+4h on create when confirmation_required).

string format: date-time
approval_token
string
agent_target

Agent_id (documentId) of the agent to execute the runbook on.

string
error_message
string
triggered_by_user
One of:

DocumentId reference to plugin::users-permissions.user

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

401

Section titled “401 ”

Missing or invalid authentication

403

Section titled “403 ”

Not authorized (tenant scope or capability)