Skip to the documentation
API

List approval requests

What runs are waiting for a person to allow, newest first.

GET/task-approvals

Runs any of 2 calls on your workspace.

GET /task-approvals

What runs are waiting for a person to allow, newest first.

Example

Needs tasks:read, threads:read and emails:read. Left alone, the list holds the requests still waiting. status asks for another state, and taskId or runId narrows it.

curl
curl "$OE/task-approvals" -H "$AUTH"curl "$OE/task-approvals/apr_2f8c1a6e9b3d47c05e1a8f2c" -H "$AUTH"
Response
{  "object": "list",  "data": [{      "object": "task_approval",      "id": "apr_2f8c1a6e9b3d47c05e1a8f2c",      "runId": "run_9d3a7e1c5b2f48a60c7e1d3b",      "taskId": "tsk_4b9e2c7a1f3d86e05a9c2b7d",      "taskName": "Morning summary",      "tool": "replyToEmail",      "summary": "Reply to [email protected]: Re: Invoice 1042",      "args": {        "threadId": "thr_7c1e4a90",        "to": ["[email protected]"],        "subject": "Re: Invoice 1042",        "body": "Hi Ann, the invoice went out again this morning."      },      "status": "pending",      "createdAt": "2026-10-13T07:00:41.220Z",      "expiresAt": "2026-10-20T07:00:41.220Z",      "decidedAt": null    }],  "hasMore": false,  "nextCursor": null}

status is pending, approved, denied, expired or cancelled.

args is exactly what the tool would be called with. Read it before you approve.

Reference