---
title: "Update Mock Tool Data"
method: PATCH
path: "/v1/mock-tool-data/{mockToolDataId}"
tags: ["Mock Tool Data"]
---

# Update Mock Tool Data

`PATCH /v1/mock-tool-data/{mockToolDataId}`

## Request

- Base URL: `https://api.sigmamind.ai`
- URL: `https://api.sigmamind.ai/v1/mock-tool-data/{mockToolDataId}`
- Auth: API key in header `X-API-Key`

Partially updates a mock tool data record for the specified agent. agentId is required. Only other provided fields are changed.

## Path parameters

- `mockToolDataId` string, required

## Request body

- UpdateMockToolDataRequest: Partial update for a mock tool data library record. Only provided fields are updated.
  - `name` string: Human-readable name for this mock.
  - `agentId` string, required: The unique identifier of the agent this mock belongs to.
  - `request` object: Optional request payload associated with this mock.
  - `response` object: Mocked HTTP response body.
  - `statusCode` 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511: HTTP status code to return when this mock is used.
  - `delay` integer: Artificial delay in milliseconds before returning the mock response.
  - `toolAlias` string: Agent tool alias this mock belongs to.

## Response `200`

OK

- MockToolDataResponse: A mock tool response stored in the tenant mock library.
  - `mockToolDataId` string: Public identifier of the mock tool data record.
  - `name` string: Human-readable name for this mock.
  - `agentId` string: The unique identifier of the agent this mock belongs to.
  - `toolId` string: Public identifier of the integration tool this mock belongs to.
  - `toolAlias` string: Agent tool alias this mock was created against.
  - `toolName` string: Display name of the tool at the time the mock was created.
  - `request` object: Request payload (or placeholders) associated with this mock.
  - `response` object: Mocked HTTP response body.
  - `statusCode` integer: HTTP status code returned when this mock is used.
  - `delay` integer: Artificial delay in milliseconds before returning the mock response.

## Other responses

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

## Changes

- **2026-11-03** `64c0435b10eb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sigmamind/apis/sigmamind-apis/changes/v1/mock-tool-data/:mockToolDataId/patch.md)

---

[API](https://skmtc.dev/sigmamind/apis/sigmamind-apis.md) - [All operations](https://skmtc.dev/sigmamind/apis/sigmamind-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmamind/apis/sigmamind-apis/revisions/783c9e4c5126?raw)