> ## 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 simulation tool-fixture create

> Set a tool fixture

Create-or-replace by scope: one fixture per tool project-wide, plus one per (tool, flow variant). Setting the same scope twice replaces the response, so CI can apply fixtures idempotently. During Roark test calls the tool guard answers with the fixture verbatim instead of generating a response; real callers are never affected.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation tool-fixture create [options]
```

> [!NOTE]
>
> Calls `POST /v1/simulation/tool-fixture`

## Options

**--tool-name** `string` *required*

The tool this fixture answers for.

**--response** `string`

The exact JSON to return.

**--customer-flow-variant-id** `string`

Pin the fixture to one flow variant (scenario). Omit for a project-wide fixture. A variant-pinned fixture beats the project-wide one.

**--description** `string`

Why this fixture exists.

**--enabled** `switch`

Defaults to true.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation tool-fixture create --tool-name <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.