Get a single tool call by ID

POST 
/api/v1/llm/get-tool-call

Reads the identified tool call from the conversation's current run state, including resolved calls retained there. An empty response means the call was not found in that current run; it does not prove the call never executed.

Match the call ID and inspect both status and result. If its answer window expired, the result reports client tool timeout. Inspect both the status and reason before deciding whether any work remains; expiration does not establish whether an action dispatched to the client took effect.

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 · Build an assistant that researches the web · Let your assistant answer questions about a customer’s calendar · Answer questions about a website using your own Firecrawl account

Request

Responses

200

The tool call

Inspect a tool call using an ID previously returned by the conversation.

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

Request example

{
  "conversationKey": "example_123",
  "toolCallId": "tool_call_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-getToolCall#example-cookbook-managed-agents-delegation-approvals-using-tools-06-request

Request example

{
  "conversationKey": "support-chat-001",
  "toolCallId": "call_306135"
}

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

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

Response example

{
  "messageSequence": "1",
  "messageId": "example_123",
  "toolCall": {
    "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-getToolCall. Section identities and revisions.

Section	Stable reference
Get a single tool call by ID	DOC-MA-conversations-api-getToolCall#overview
Request	DOC-MA-conversations-api-getToolCall#request
Responses	DOC-MA-conversations-api-getToolCall#responses