---
title: "Update a tool fixture"
method: PUT
path: "/v1/simulation/tool-fixture/{fixtureId}"
tags: ["Simulation"]
---

# Update a tool fixture

`PUT /v1/simulation/tool-fixture/{fixtureId}`

## Request

- Base URL: `https://api.roark.ai`
- URL: `https://api.roark.ai/v1/simulation/tool-fixture/{fixtureId}`
- Auth: HTTP bearer

Change the response, description, or enabled state of an existing fixture.

## Path parameters

- `fixtureId` string, uuid, required

## Request body

- UpdateSimulationToolFixtureRequest
  - `response` unknown
  - `description` string, nullable
  - `enabled` boolean

## Response `200`

The updated fixture.

- object
  - `data` SimulationToolFixture, required: A deterministic tool response for Roark test calls: where the scenario-aware model makes mocked tools plausible, a fixture makes one exact, so a simulation can force the branch under test. Never applies to real callers.
    - `id` string, uuid, required
    - `toolName` string, required
    - `customerFlowVariantId` string, uuid, nullable, required: The flow variant this fixture is pinned to. Null = project-wide.
    - `response` unknown
    - `description` string, nullable, required: Why this fixture exists.
    - `enabled` boolean, required
    - `createdAt` string, required: ISO 8601.
    - `updatedAt` string, required: ISO 8601.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

> 187 revisions in range; 1 not diffed.

- **2026-09-23** `1ecd4d7c5fe7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/simulation/tool-fixture/:fixtureId/put.md)

---

[API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [All operations](https://skmtc.dev/roarkhq/apis/roark-analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roarkhq/apis/roark-analytics-api/revisions/1a91a5c90e44?raw)