API reference

Actions

2 operations. REST https://dev.tlntconnect.com/api/v1

GET/api/v1/actions/{action_id}The outcome of an action this key ran (or queued before approvals were removed): executed, approved (still running), failed, cancelled, pending, rejected or expired.

Read an action_id from an executed, pending_approval or already_decided response. Only THIS key's actions are visible; any other id is 404. status: executed (done — result names what changed), approved (still running), failed (the run failed), cancelled; an action queued before approvals were removed (TLN-1770) may also read pending, rejected (review_note carries the reviewer's note, when given) or expired. Poll a running action with backoff (e.g. every 30-60 s).

Scopes
none
Members
admin, manager, scout, viewer
Idempotency-Key
Ignored (read)
Rate weight
1
Untrusted fields
review_note

Input

action_id path, requiredstring (uuid) — The action_id from an executed, pending_approval or already_decided response.

Responses

200Success
400invalid_input / invalid_json / invalid_id
401missing_token / invalid_token / revoked_token / expired_token
403missing_scope / actor_unavailable / plan_upgrade_required / role_forbidden
404not_found (unknown, cross-workspace or not visible to the key's member)
429rate_limited (honour Retry-After)
500internal_error
GET/api/v1/actionsActions this key ran (or queued before approvals were removed), newest first, with their current status.

The actions THIS key ran (or queued before approvals were removed), newest first (other keys' actions never appear). Same row shape as GET /actions/{action_id}. Paged with page/limit (limit ≤ 50, default 20); a page is shorter than limit only on the last page, or if Atlas data retention removes an action while you page (a removed action takes its row with it).

Scopes
none
Members
admin, manager, scout, viewer
Idempotency-Key
Ignored (read)
Rate weight
1
Untrusted fields
review_note

Input

limit queryinteger — Page size, default 20.
page queryinteger — 1-based page, default 1.

Responses

200Success
400invalid_input / invalid_json / invalid_id
401missing_token / invalid_token / revoked_token / expired_token
403missing_scope / actor_unavailable / plan_upgrade_required / role_forbidden
404not_found (unknown, cross-workspace or not visible to the key's member)
429rate_limited (honour Retry-After)
500internal_error