API ReferenceAgents

Get Task Agent Approval Request

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. agent_reason, when present, is plain untrusted text authored by the model for this specific tool call.

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.

OR
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.

Allowed values:
action_mode_snapshotstring
tool_typeenum
TaskAgent tool source categories for action controls.
Allowed values:
tool_namestring
tool_refmap from strings to any
tool_args_hashstring
statusenum
Lifecycle status for TaskAgent tool approval requests.
Allowed values:
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
agent_reasonstring or nullOptional<=1000 characters

Optional untrusted model-authored rationale, displayed as Agent reason.

decisionenum or nullOptional
Human decision values for TaskAgent approval requests.
Allowed values:
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