Deployments.ai Docs
Runtime

List tool calls for a run (client tools show executionType, input, expiresAt)

GET /v1/runs/{runId}/tool-calls · SDK listRunToolCalls · CLI deployments tool-call list

GET
/v1/runs/{runId}/tool-calls

Requires runs:read.

Authorization

headerAuthorizationBearer <token>

Opaque bearer credential scoped to one service account and tenant.

Path Parameters

runId*string
Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Query Parameters

cursor?string

Opaque cursor returned by the previous page.

Length1 <= length <= 4096
limit?integer

Maximum number of resources to return.

Range1 <= value <= 100

Header Parameters

x-deployments-environment?string

Required with a platform bearer JWT, where the three tenant headers select an environment the caller can access through active organization membership. Optional with an API key; when supplied, it must match the key's tenant.

Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$
x-deployments-organization?string

Required with a platform bearer JWT, where the three tenant headers select an environment the caller can access through active organization membership. Optional with an API key; when supplied, it must match the key's tenant.

Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$
x-deployments-project?string

Required with a platform bearer JWT, where the three tenant headers select an environment the caller can access through active organization membership. Optional with an API key; when supplied, it must match the key's tenant.

Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Response Body

ListToolCallsResponse

application/json
  1. response
nextCursor?|null
toolCalls*array<>
curl -X GET "https://example.com/v1/runs/string/tool-calls"
{  "nextCursor": "string",  "toolCalls": [    {      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "version": 0,      "environmentId": "string",      "organizationId": "string",      "projectId": "string",      "approvalId": "string",      "completedAt": "2019-08-24T14:15:22Z",      "effect": "execute",      "executionType": "client",      "expiresAt": "2019-08-24T14:15:22Z",      "externalOperationId": "string",      "id": "string",      "input": {        "property1": null,        "property2": null      },      "inputSummary": "string",      "modelAttemptId": "string",      "modelCallIndex": 0,      "object": "tool-call",      "output": {        "property1": null,        "property2": null      },      "outputSchema": {        "property1": null,        "property2": null      },      "outputSummary": "string",      "policyAction": "allow",      "policyReason": "string",      "requiredScopes": [        "string"      ],      "runId": "string",      "startedAt": "2019-08-24T14:15:22Z",      "status": "failed",      "toolAdapterId": "string",      "toolName": "string",      "toolPlanFingerprint": "string"    }  ]}