List pending tool approvals

POST 
/api/v1/llm/list-pending-approvals

Returns all tool calls in the active generation run that are awaiting human approval. Used when the tool execution policy requires confirmation before executing certain tools.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Approve a tool action and finish the conversation · Event catalog

Request

Responses

200

Pending approvals listed

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.

Section ID: DOC-MA-conversations-api-listPendingApprovals#example-conversations-listPendingApprovals-request

Request example

{
  "conversationKey": "example_123"
}

Guide request for Step 2: Show the action awaiting a decision. Replace example resource identifiers with your own authorized values.

Section ID: DOC-MA-conversations-api-listPendingApprovals#example-cookbook-managed-agents-delegation-approvals-using-tools-01-request

Request example

{
  "conversationKey": "support-chat-001"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-MA-conversations-api-listPendingApprovals#example-conversations-listPendingApprovals-response

Response example

{
  "toolCalls": [
    {
      "id": "example_123",
      "name": "example",
      "argumentsJson": {
        "example": "value"
      },
      "status": "TOOL_EXECUTION_STATUS_PENDING",
      "resultJson": {
        "example": "value"
      },
      "executedAt": "2026-09-16T12:00:00Z",
      "serverId": "example_123",
      "isClientTool": true,
      "description": "example",
      "parametersJsonSchema": {
        "example": "value"
      },
      "requiresApprovalAt": "2026-09-16T12:00:00Z",
      "approvedAt": "2026-09-16T12:00:00Z",
      "approvedBy": "example",
      "executionDuration": "1s",
      "endReason": "example",
      "clientToolDeadlineAt": "2026-09-16T12:00:00Z"
    }
  ]
}

Document ID: DOC-MA-conversations-api-listPendingApprovals. Section identities and revisions.

Section	Stable reference
List pending tool approvals	DOC-MA-conversations-api-listPendingApprovals#overview
Request	DOC-MA-conversations-api-listPendingApprovals#request
Responses	DOC-MA-conversations-api-listPendingApprovals#responses