Approve Task Agent Approval Request

POST

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

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task-agent/task_agent_id/approval-request/approval_request_id/approve \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "decision_note": "Checked the recipient list; safe to send."
> }'

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": "approved",
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   "decided_by_user_id": "019df7a2-44a0-7f54-8478-e19c351d1cc8",
26   "requester_is_decider": false,
27   "tool_action_control_id": "019fa2e2-2f00-7d54-ab2e-0fd98d058991",
28   "tool_args_preview": {
29     "range": "Tickets!A:D",
30     "spreadsheet_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms",
31     "value_input_option": "USER_ENTERED",
32     "values": [
33       [
34         "NJ-1042",
35         "TCK-4821",
36         "resolved",
37         "2026-07-27"
38       ]
39     ]
40   },
41   "decision": "approved",
42   "decision_note": "Approved — logging the resolved ticket is fine.",
43   "modified": "2026-07-27T09:24:15Z",
44   "decided_at": "2026-07-27T09:24:15Z"
45 }

Approve a pending human approval request.

Approving records the human decision and creates a bounded one-shot allowance for the exact proposed tool call. Approval does not automatically execute the agent; callers must invoke the explicit resume endpoint to continue the paused run.

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

Request

This endpoint expects an object.

decision_notestring or nullOptional<=2000 characters

expires_atdatetime or nullOptional

Optional shorter one-shot allowance expiry for a future resume path.

Response

Task Agent approval request approved

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

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error