Get Task Agent Approval Request

GET

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

GET

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

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

1 {
2   "id": "019fa2e2-2f00-71c7-aee7-539ab31cd302",
3   "project_id": "0190a234-9876-5432-10ab-cdef01234567",
4   "task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
5   "task_agent_revision_id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
6   "task_agent_run_id": "019fa2e2-2f00-7be2-bcf0-f056f44f700a",
7   "session_id": "019fa2da-4790-7718-8edc-ae551b239242",
8   "adk_session_user_id": "0190c234-1111-2222-3333-444444444444",
9   "function_call_id": "call-4f19a7c3e8b2",
10   "requested_by_actor_type": "user",
11   "action_mode_snapshot": "require_approval",
12   "tool_type": "integration",
13   "tool_name": "sheets_spreadsheets_values_append",
14   "tool_ref": {
15     "integration_tool_id": "019df7a2-44a0-7923-9ea9-87be4ba93be9",
16     "project_integration_id": "019df7a2-44a0-7a75-ae4f-4c8edcdac22e"
17   },
18   "tool_args_hash": "e3f1c9a7b2d4f6081a5c9e3d7b2f4a6081c5e9d3b7f2a4c6081e5d9c3b7f2a46",
19   "status": "pending",
20   "created": "2026-07-27T09:22:41Z",
21   "expires_at": "2026-07-27T10:22:41Z",
22   "invocation_id": "019fa2e2-2f00-7a54-9f70-cd49ad3571d2",
23   "adk_event_id": "019fa2e2-2f00-77e0-a459-008f7d11e9f8",
24   "requested_by_user_id": "0190c234-1111-2222-3333-444444444444",
25   "requester_is_decider": false,
26   "tool_action_control_id": "019fa2e2-2f00-7d54-ab2e-0fd98d058991",
27   "tool_args_preview": {
28     "range": "Tickets!A:D",
29     "spreadsheet_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms",
30     "value_input_option": "USER_ENTERED",
31     "values": [
32       [
33         "NJ-1042",
34         "TCK-4821",
35         "resolved",
36         "2026-07-27"
37       ]
38     ]
39   },
40   "modified": "2026-07-27T09:22:41Z"
41 }

Retrieve a human approval request for a proposed tool call. The request is visible only when the caller can read the linked Task Agent run. If the request is pending and has expired, it is transitioned to expired before the response is returned.

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

approval_request_idstringRequiredformat: "uuid"

The approval request ID

Response

Task Agent approval request

idstringformat: "uuid"

project_idstringformat: "uuid"

task_agent_idstringformat: "uuid"

task_agent_revision_idstringformat: "uuid"

task_agent_run_idstringformat: "uuid"

session_idstring

adk_session_user_idstring

function_call_idstring

requested_by_actor_typeenum

Actor source that requested an approval-gated action.

action_mode_snapshotstring

tool_typeenum

TaskAgent tool source categories for action controls.

tool_namestring

tool_refmap from strings to any

tool_args_hashstring

statusenum

Lifecycle status for TaskAgent tool approval requests.

createdstring

expires_atstring

invocation_idstring or nullOptional

adk_event_idstring or nullOptional

requested_by_user_idstring or nullOptionalformat: "uuid"

requested_by_actor_refmap from strings to any or nullOptional

decided_by_user_idstring or nullOptionalformat: "uuid"

requester_is_deciderbooleanOptionalDefaults to false

tool_action_control_idstring or nullOptionalformat: "uuid"

tool_args_previewmap from strings to any or nullOptional

decisionenum or nullOptional

Human decision values for TaskAgent approval requests.

decision_notestring or nullOptional

modifiedstring or nullOptional

decided_atstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error