Skip to main content
Attach tool invocations that fired during a call to an already-existing call, asynchronously after the call was created. Use this when the tool-call data becomes available later than the call itself (e.g. a Roark simulation, or a call submitted via POST /v1/call before its tools were ready). Writes are idempotent: re-sending an invocation already present on the call (same tool name and timing) is skipped, so retries converge instead of double-counting. Optionally pass metrics to (re)score metrics over the newly attached tools, which triggers a billed metric collection job and requires the metric:create permission.
Calls POST /v1/call/{callId}/tool-invocations

​
Arguments

​
string
required
The call-id.

​
Options

​
array
required
Tool invocations that fired during the call, to attach to it. Max 500 per request. Re-sending an invocation already present on the call (same tool name and timing) is skipped, so retries are safe.
​
array
Optional. Metric definitions to (re)score on this call after the tool invocations are attached, e.g. the Tool Invocation Analysis metrics. Triggers a metric collection job (billed, credit-gated) and requires the ‘metric:create’ permission. Omit to attach tools without scoring. Max 20.

​
Example

Every command also takes the global options and sets one of the exit codes.