List Task Agent Approval Requests

GET

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

GET

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

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

1 {
2   "results": [
3     {
4       "id": "string",
5       "project_id": "string",
6       "task_agent_id": "string",
7       "task_agent_revision_id": "string",
8       "task_agent_run_id": "string",
9       "session_id": "string",
10       "adk_session_user_id": "string",
11       "function_call_id": "string",
12       "requested_by_actor_type": "user",
13       "action_mode_snapshot": "string",
14       "tool_type": "task",
15       "tool_name": "string",
16       "tool_ref": {},
17       "tool_args_hash": "string",
18       "status": "pending",
19       "created": "string",
20       "expires_at": "string",
21       "invocation_id": "string",
22       "adk_event_id": "string",
23       "requested_by_user_id": "string",
24       "requested_by_actor_ref": {},
25       "decided_by_user_id": "string",
26       "requester_is_decider": false,
27       "tool_action_control_id": "string",
28       "tool_args_preview": {},
29       "decision": "approved",
30       "decision_note": "string",
31       "modified": "string",
32       "decided_at": "string"
33     }
34   ],
35   "pagination": {
36     "next_cursor": "019097c5-5560-05b5-4a48-5197a269683b",
37     "has_next": true,
38     "page_limit": 100
39   }
40 }

List human approval requests for proposed Task Agent tool calls. 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.

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

task_agent_idstringRequiredformat: "uuid"

The task agent ID

Query parameters

statusenumOptional

Filter by approval request status.

Allowed values:

run_idstringOptionalformat: "uuid"

Filter by TaskAgentRun ID.

session_idstringOptional

Filter by ADK session ID.

tool_typeenumOptional

Filter by tool source.

Allowed values:

created_afterdatetimeOptional

Filter approval requests created at/after this timestamp.

created_beforedatetimeOptional

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.

cursorstringOptional

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

Response

Task Agent approval requests

resultslist of objects

The list of items returned for the current page.

paginationobject or null

Contains pagination information for the result set.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error