Skip to main content

List client-side tool calls awaiting a result

POST 
/api/v1/llm/list-pending-client-tools

Returns the client-side tool calls the run is currently waiting on, with the message each belongs to. Use it to recover after a dropped connection, or from a caller that never holds one.

On reconnect, pull with this call and then submit — do not resend the original user message, which would start a second run and interrupt the one you were waiting on.

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: Let a customer navigate your app through chat

Request​

Responses​

Outstanding client-side tool calls

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

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

Request example

{
  "conversationKey": "example_123"
}

Guide request for Recover the original call after a disconnect. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-listPendingClientTools#example-cookbook-managed-agents-delegation-approvals-using-tools-05-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-listPendingClientTools#example-conversations-listPendingClientTools-response

Response example

{
  "messageSequences": [
    "1"
  ],
  "messageIds": [
    "example_123"
  ],
  "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-listPendingClientTools. Section identities and revisions.

SectionStable reference
List client-side tool calls awaiting a resultDOC-MA-conversations-api-listPendingClientTools#overview
RequestDOC-MA-conversations-api-listPendingClientTools#request
ResponsesDOC-MA-conversations-api-listPendingClientTools#responses