Skip to navigation
API ReferenceAgents

List Task Agent Approval Requests

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.

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

Query parameters

statusenum or nullOptional
Filter by approval request status.
Allowed values:
run_idstring or nullOptionalformat: "uuid"
Filter by TaskAgentRun ID.
session_idstring or nullOptional
Filter by ADK session ID.
tool_typeenum or nullOptional
Filter by tool source.
Allowed values:
created_afterdatetime or nullOptional

Filter approval requests created at/after this timestamp.

created_beforedatetime or nullOptional

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.

cursorstring or nullOptional

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 nullOptional
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