Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

callId
string<uuid>
required

Body

application/json

Attach tool invocations to an existing call, optionally (re)scoring metrics over them.

toolInvocations
object[]
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.

Required array length: 1 - 500 elements
metrics
object[]

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.

Required array length: 1 - 20 elements

Response

Tool invocations attached to the call

data
object
required

Result of appending tool invocations to a call.