List Project Task Agent Approval Requests

GET

/org/:org_id/project/:project_id/task-agent/approval-request

GET

/api/v1/org/:org_id/project/:project_id/task-agent/approval-request

$ curl https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task-agent/approval-request \
>      -H "Authorization: Bearer <token>"

1 {
2   "results": [
3     {
4       "id": "019fa2e2-2f00-71c7-aee7-539ab31cd302",
5       "project_id": "0190a234-9876-5432-10ab-cdef01234567",
6       "task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
7       "task_agent_revision_id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
8       "task_agent_run_id": "019fa2e2-2f00-7be2-bcf0-f056f44f700a",
9       "session_id": "019fa2da-4790-7718-8edc-ae551b239242",
10       "adk_session_user_id": "0190c234-1111-2222-3333-444444444444",
11       "function_call_id": "call-4f19a7c3e8b2",
12       "requested_by_actor_type": "user",
13       "action_mode_snapshot": "require_approval",
14       "tool_type": "integration",
15       "tool_name": "sheets_spreadsheets_values_append",
16       "status": "pending",
17       "created": "2026-07-27T09:22:41Z",
18       "expires_at": "2026-07-27T10:22:41Z",
19       "task_agent_name": "Support Triage Agent",
20       "invocation_id": "019fa2e2-2f00-7a54-9f70-cd49ad3571d2",
21       "adk_event_id": "019fa2e2-2f00-77e0-a459-008f7d11e9f8",
22       "requested_by_user_id": "0190c234-1111-2222-3333-444444444444",
23       "requester_is_decider": false,
24       "tool_action_control_id": "019fa2e2-2f00-7d54-ab2e-0fd98d058991",
25       "modified": "2026-07-27T09:22:41Z"
26     }
27   ],
28   "pagination": {
29     "has_next": false,
30     "page_limit": 25
31   }
32 }

List human approval requests for visible Task Agents in a project.

Approval requests are visible through the same visibility rules as their linked Task Agent run. Pending requests may be returned as expired when their approval window has elapsed. This project-scoped list is compact and omits tool argument payloads, raw tool references, and full user records.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

Query parameters

task_agent_idstring or nullOptionalformat: "uuid"

Filter by TaskAgent ID.

statusenum or nullOptional

Filter by approval request status.

Allowed values:

run_idstring or nullOptionalformat: "uuid"

Filter by TaskAgentRun ID.

session_idstring or nullOptional

Filter by ADK session ID.

tool_typeenum or nullOptional

Filter by tool source.

Allowed values:

created_afterdatetime or nullOptional

Filter approval requests created at/after this timestamp.

created_beforedatetime or nullOptional

Filter approval requests created at/before this timestamp.

page_limitintegerOptional1-100Defaults to 100

The maximum number of items to return per page. Defaults to 100 if not specified.

cursorstring or nullOptional

A cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.

Response

Project Task Agent approval requests

resultslist of objects

The list of items returned for the current page.

paginationobject or nullOptional

Contains pagination information for the result set.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error