Reject Task Agent Approval Request

POST

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

POST

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

$ 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/reject \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "decision_note": "Recipient list includes external addresses."
> }'

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": "rejected",
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": "rejected",
42   "decision_note": "Don't log yet — waiting on the client to confirm the refund amount.",
43   "modified": "2026-07-27T09:24:15Z",
44   "decided_at": "2026-07-27T09:24:15Z"
45 }

Reject a pending human approval request.

The default rejection behavior fails the linked paused Task Agent run with an approval rejection termination reason. When the matched action control uses return_rejection_to_model, rejection records the decision and leaves the run waiting until the explicit resume endpoint returns the controlled rejection function response to the model.

Reject a pending human approval request. The default rejection behavior fails the linked paused Task Agent run with an approval rejection termination reason. When the matched action control uses `return_rejection_to_model`, rejection records the decision and leaves the run waiting until the explicit resume endpoint returns the controlled rejection function response to the model.

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

Response

Task Agent approval request rejected

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