---
title: "Create Mock Tool Data"
method: POST
path: "/v1/mock-tool-data"
tags: ["Mock Tool Data"]
---

# Create Mock Tool Data

`POST /v1/mock-tool-data`

## Request

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

Creates a named mock tool data in the tenant mock library. Use this for manual mock tool data creation or after capturing a live tool execute. Returns the created mock including its mockToolDataId.

## Request body

- CreateMockToolDataRequest: Request body to create a named mock tool response in the tenant mock library.
  - `name` string, required: Human-readable name for this mock, used when picking mocks in the test-case UI.
  - `agentId` string, required: The unique identifier of the agent this mock belongs to.
  - `toolId` string: Identifier of the integration tool this mock belongs to. Optional when toolAlias can uniquely resolve the tool.
  - `request` object: Optional request payload (or placeholders) associated with this mock, for documentation and capture.
  - `response` object, required: Mocked HTTP response body returned when this mock is used during simulation.
  - `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, required: HTTP status code to return when this mock is used.
  - `delay` integer: Artificial delay in milliseconds before returning the mock response. Defaults to 0.
  - `toolAlias` string, required: Agent tool alias this mock is bound to.

## Response `201`

Created

- 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/post.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)