curl "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/approvals" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api session approvals list a6414511-4430-4e1f-8c51-8ea8824dadec
[
{
"id": "ap_7c2d",
"session_id": "a6414511-4430-4e1f-8c51-8ea8824dadec",
"kind": "deploy",
"message": "Deploy the updated landing page to production?",
"required_role": "admin",
"required_team_id": null,
"status": "pending",
"requested_by": "sandbox",
"created_at": "2026-07-28T18:12:00Z",
"resolved_by": null,
"resolved_at": null,
"resolution_note": null
}
]
Approvals
List Approvals
List a session’s approval requests, newest first
GET
/
api
/
sessions
/
{session_id}
/
approvals
curl "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/approvals" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api session approvals list a6414511-4430-4e1f-8c51-8ea8824dadec
[
{
"id": "ap_7c2d",
"session_id": "a6414511-4430-4e1f-8c51-8ea8824dadec",
"kind": "deploy",
"message": "Deploy the updated landing page to production?",
"required_role": "admin",
"required_team_id": null,
"status": "pending",
"requested_by": "sandbox",
"created_at": "2026-07-28T18:12:00Z",
"resolved_by": null,
"resolved_at": null,
"resolution_note": null
}
]
Autopilot runs can pause on an approval gate (a deploy, a guarded action) and wait for a human decision. This lists the session’s approval requests so an unattended run that stalls can be diagnosed in-band. Resolve with Resolve Approval.
Required scope:
sessions:read
Path Parameters
string
required
The session ID.
Response
A JSON array of approval objects.string
Approval ID.
string
The session that requested it.
string
What is being approved, for example
deploy.string | null
The agent’s request message.
string | null
Org role required to resolve, when constrained.
string | null
Group membership required to resolve, when constrained.
string
pending, approved, or rejected.string
Who requested the approval (usually the sandbox).
string
When the request was made.
string | null
Who resolved it.
string | null
When it was resolved.
string | null
The note left at resolution.
curl "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/approvals" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api session approvals list a6414511-4430-4e1f-8c51-8ea8824dadec
[
{
"id": "ap_7c2d",
"session_id": "a6414511-4430-4e1f-8c51-8ea8824dadec",
"kind": "deploy",
"message": "Deploy the updated landing page to production?",
"required_role": "admin",
"required_team_id": null,
"status": "pending",
"requested_by": "sandbox",
"created_at": "2026-07-28T18:12:00Z",
"resolved_by": null,
"resolved_at": null,
"resolution_note": null
}
]