#ActionRuns

---

#GET /{o}/{p}/envs/{envName}/action-runs

List action runs

List action runs in this environment with optional filtering and pagination.

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string
envName	string

Responses

Status	Description	Schema
200	Action runs	ActionRunList

---

#GET /{o}/{p}/envs/{envName}/action-runs/{id}

Get an action run by id

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string
envName	string
id	string

Responses

Status	Description	Schema
200	The action run	ActionRun
404	Action run not found	Error

---

#DELETE /{o}/{p}/envs/{envName}/action-runs/{id}

Cancel a pending action run

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string
envName	string
id	string

Responses

Status	Description	Schema
200	Cancelled action run	ActionRun
404	Action run not found	Error
409	Run is not in a cancellable state	Error

---

#POST /{o}/{p}/envs/{envName}/action-runs/{id}/callback

Complete an action run (external workflow callback)

Called by the external workflow to report success/failure. Authenticated by a per-run HMAC-signed callback token in the Authorization header — not by an RBAC token.

Auth: Bearer token required

Path parameters

Name	Type	Description
o	string
p	string
envName	string
id	string

Request body (application/json)

Type: object | object

Responses

Status	Description	Schema
200	Completed action run	ActionRun
401	Invalid or expired callback token	Error
404	Action run not found	Error
409	Run is not in a completable state	Error

#Schemas

#ActionRun

Field	Type	Description
id	string(uuid)	(required)
actionName	string	(required)
entityId	string,null(uuid)	(required)
status	pending | running | succeeded | failed | cancelled	(required)
parameters	object	(required)
recommendations	object	(required)
triggeredBy	string	(required)
createdAt	string(date-time)	(required)
startedAt	string,null(date-time)	(required)
completedAt	string,null(date-time)	(required)
error	string,null	(required)
output	object,null	(required)

#ActionRunList

Type: ActionRun[]

#Error

Field	Type	Description
error	string	(required)
code	string