> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark call tool-invocation append

> Append tool invocations to a call

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.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark call tool-invocation append <call-id> [options]
```

> [!NOTE]
>
> Calls `POST /v1/call/{callId}/tool-invocations`

## Arguments

**call-id** `string` *required*

The call-id.

## Options

**--tool-invocations** `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.

**--metrics** `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

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark call tool-invocation append <call-id> --tool-invocations <value>
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.