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

# Tools

API operations for tools. Browse the routes below for parameters, request examples, and responses.

API version: Selected per operation

## List tools

Returns every tool in the environment, including workflow tools. A tool is something a playbook can call during a conversation. The call takes no paging parameters, so one request yields the whole set.

### Endpoint

```http
GET /v2/stable/tool
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Query parameters

#### `global`

Optional · boolean

Target the agent. Cannot be used with playbookID.

```json
{
  "description": "Target the agent. Cannot be used with playbookID.",
  "type": "boolean"
}
```

#### `playbookID`

Optional · string

Target a specific playbook. Cannot be used with global.

```json
{
  "description": "Target a specific playbook. Cannot be used with global.",
  "type": "string"
}
```

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

#### `type`

Optional · enum<string>

When provided, only tools of this type are returned. `workflow` returns the workflow tools.

```json
{
  "description": "When provided, only tools of this type are returned. `workflow` returns the workflow tools.",
  "type": "string",
  "enum": [
    "api",
    "mcp",
    "function",
    "integration",
    "workflow"
  ],
  "x-enumNames": [
    "API",
    "MCP",
    "FUNCTION",
    "INTEGRATION",
    "WORKFLOW"
  ]
}
```

### Responses

#### 200

Returns the tools attached to the agent or to a single playbook, depending on whether you pass global or playbookID. Each entry is the attachment rather than the underlying resource: it points at an API tool, function, MCP tool, integration tool or workflow by ID and carries the description, input mappings, and response capture used when the agent calls it.

Schema:

```json
{
  "$ref": "#/components/schemas/StableToolListResponseV2"
}
```

Example:

```json
{
  "tools": [
    {
      "id": "<string>",
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "messages": "<StableToolMessages>",
      "toolSound": "<ToolNodeDataToolSound>",
      "description": "<string>",
      "captureInputVariables": {},
      "type": "api",
      "apiToolID": "<string>",
      "asyncExecution": true,
      "inputVariables": {},
      "captureResponse": {}
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request GET \
  --url 'https://realtime-api.voiceflow.com/v2/stable/tool?global=<global>&playbookID=<playbookID>&projectID=<projectID>&environmentAlias=<environmentAlias>&type=<type>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v2/stable/tool?global=<global>&playbookID=<playbookID>&projectID=<projectID>&environmentAlias=<environmentAlias>&type=<type>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v2/stable/tool?global=<global>&playbookID=<playbookID>&projectID=<projectID>&environmentAlias=<environmentAlias>&type=<type>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf tool list --global <global> --playbook-id <playbookID> --project-id <projectID> --environment-alias <environmentAlias> --type <type>
```


## Create tool

Adds a tool to the environment, or gives the agent a workflow tool. A tool is something a playbook can call during a conversation. Message text and default input values are plain strings, and the response carries the ID that later calls address it by.

### Endpoint

```http
POST /v2/stable/tool
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Request body

Required

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StableToolCreateRequestV2"
      }
    }
  }
}
```

### Responses

#### 201

Attaches an existing API tool, function, MCP tool, integration tool or workflow to the agent or to a playbook, and returns the attachment with its generated ID and wiring. The underlying resource is referenced by ID and is not created here.

Schema:

```json
{
  "$ref": "#/components/schemas/StableToolResponseV2"
}
```

Example:

```json
{
  "tool": {
    "id": "<string>",
    "createdAt": "2026-09-10T00:00:00.000Z",
    "updatedAt": "2026-09-10T00:00:00.000Z",
    "messages": "<StableToolMessages>",
    "toolSound": "<ToolNodeDataToolSound>",
    "description": "<string>",
    "captureInputVariables": {},
    "type": "api",
    "apiToolID": "<string>",
    "asyncExecution": true,
    "inputVariables": {},
    "captureResponse": {}
  },
  "unresolvedReferences": [
    {
      "path": "<string>",
      "token": "<string>",
      "reason": "unknown"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v2/stable/tool?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "<string>",
  "target": {
    "global": true,
    "playbookID": "<string>"
  },
  "messages": null,
  "captureInputVariables": {},
  "toolSound": null,
  "asyncExecution": false,
  "inputVariables": {},
  "captureResponse": {},
  "type": "api",
  "apiToolID": "<string>"
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v2/stable/tool?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "description": "<string>",
    "target": {
      "global": true,
      "playbookID": "<string>"
    },
    "messages": null,
    "captureInputVariables": {},
    "toolSound": null,
    "asyncExecution": false,
    "inputVariables": {},
    "captureResponse": {},
    "type": "api",
    "apiToolID": "<string>"
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v2/stable/tool?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "description": "<string>",
      "target": {
        "global": True,
        "playbookID": "<string>"
      },
      "messages": None,
      "captureInputVariables": {},
      "toolSound": None,
      "asyncExecution": False,
      "inputVariables": {},
      "captureResponse": {},
      "type": "api",
      "apiToolID": "<string>"
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf tool create --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "description": "<string>",
  "target": {
    "global": true,
    "playbookID": "<string>"
  },
  "messages": null,
  "captureInputVariables": {},
  "toolSound": null,
  "asyncExecution": false,
  "inputVariables": {},
  "captureResponse": {},
  "type": "api",
  "apiToolID": "<string>"
}
JSON
```


## Create many tools

Adds several tools to the environment in one request, each taking the fields the single-create call takes, with message text and default input values as plain strings. The response carries the created tools in the same shape the list call returns.

### Endpoint

```http
POST /v2/stable/tool/batch
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Request body

Required

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StableToolCreateManyRequestV2"
      }
    }
  }
}
```

### Responses

#### 201

Attaches several tools to the same target in one call and returns each attachment with its generated ID. The request carries a single type and a single target, so tools of different types need separate calls.

Schema:

```json
{
  "$ref": "#/components/schemas/StableToolCreateManyResponse"
}
```

Example:

```json
{
  "tools": [
    {
      "id": "<string>",
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "messages": "<StableToolMessages>",
      "toolSound": "<ToolNodeDataToolSound>",
      "description": "<string>",
      "captureInputVariables": {},
      "type": "api",
      "apiToolID": "<string>",
      "asyncExecution": true,
      "inputVariables": {},
      "captureResponse": {}
    }
  ],
  "unresolvedReferences": [
    {
      "path": "<string>",
      "token": "<string>",
      "reason": "unknown"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v2/stable/tool/batch?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "api",
  "target": {
    "global": true,
    "playbookID": "<string>"
  },
  "tools": [
    {
      "description": "<string>",
      "messages": null,
      "captureInputVariables": {},
      "toolSound": null,
      "asyncExecution": false,
      "inputVariables": {},
      "captureResponse": {},
      "apiToolID": "<string>"
    }
  ]
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v2/stable/tool/batch?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "api",
    "target": {
      "global": true,
      "playbookID": "<string>"
    },
    "tools": [
      {
        "description": "<string>",
        "messages": null,
        "captureInputVariables": {},
        "toolSound": null,
        "asyncExecution": false,
        "inputVariables": {},
        "captureResponse": {},
        "apiToolID": "<string>"
      }
    ]
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v2/stable/tool/batch?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "type": "api",
      "target": {
        "global": True,
        "playbookID": "<string>"
      },
      "tools": [
        {
          "description": "<string>",
          "messages": None,
          "captureInputVariables": {},
          "toolSound": None,
          "asyncExecution": False,
          "inputVariables": {},
          "captureResponse": {},
          "apiToolID": "<string>"
        }
      ]
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf tool create-many --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "type": "api",
  "target": {
    "global": true,
    "playbookID": "<string>"
  },
  "tools": [
    {
      "description": "<string>",
      "messages": null,
      "captureInputVariables": {},
      "toolSound": null,
      "asyncExecution": false,
      "inputVariables": {},
      "captureResponse": {},
      "apiToolID": "<string>"
    }
  ]
}
JSON
```


## Get tool

Returns a single tool by ID, including a workflow tool, with the fields that define it. A tool is something a playbook can call during a conversation.

### Endpoint

```http
GET /v2/stable/tool/{toolID}
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `toolID`

Required · string

The ID of the tool to operate on.

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

#### `type`

Required · enum<string>

The type of the tool to fetch.

```json
{
  "type": "string",
  "enum": [
    "api",
    "mcp",
    "function",
    "integration",
    "workflow"
  ],
  "description": "The type of the tool to fetch.",
  "x-enumNames": [
    "API",
    "MCP",
    "FUNCTION",
    "INTEGRATION",
    "WORKFLOW"
  ]
}
```

### Responses

#### 200

Returns one attached tool with the resource it points at, the description the agent reads, its input mappings, and where its response is captured. The required type parameter selects which of the five shapes, API, function, MCP, integration or workflow, comes back.

Schema:

```json
{
  "$ref": "#/components/schemas/StableToolReadResponse"
}
```

Example:

```json
{
  "tool": {
    "id": "<string>",
    "createdAt": "2026-09-10T00:00:00.000Z",
    "updatedAt": "2026-09-10T00:00:00.000Z",
    "messages": "<StableToolMessages>",
    "toolSound": "<ToolNodeDataToolSound>",
    "description": "<string>",
    "captureInputVariables": {},
    "type": "api",
    "apiToolID": "<string>",
    "asyncExecution": true,
    "inputVariables": {},
    "captureResponse": {}
  }
}
```

### Request examples

#### cURL

```bash
curl --request GET \
  --url 'https://realtime-api.voiceflow.com/v2/stable/tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>&type=<type>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v2/stable/tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>&type=<type>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v2/stable/tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>&type=<type>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf tool get --tool-id <toolID> --project-id <projectID> --environment-alias <environmentAlias> --type <type>
```


## Update tool

Changes an existing tool attachment in place, taking message text and default input values as plain strings. The response lists any references that did not resolve; read the tool again to see its new values.

### Endpoint

```http
PATCH /v2/stable/tool/{toolID}
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `toolID`

Required · string

The ID of the tool to operate on.

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Request body

Required

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StableToolUpdateRequestV2"
      }
    }
  }
}
```

### Responses

#### 200

Confirms the attachment's wiring was updated, meaning its description, input mappings, or capture settings rather than the API tool, function, or MCP tool it points at. The body is a message only, so refetch the tool to read its current state.

Schema:

```json
{
  "$ref": "#/components/schemas/StableTextUpdateResponse"
}
```

Example:

```json
{
  "message": "<string>",
  "unresolvedReferences": [
    {
      "path": "<string>",
      "token": "<string>",
      "reason": "unknown"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request PATCH \
  --url 'https://realtime-api.voiceflow.com/v2/stable/tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "<string>",
  "messages": {
    "generative": {
      "execution": "<StableToolMessageGenerative>",
      "failure": "<StableToolMessageGenerative>",
      "delay": "<StableToolMessageGenerative>",
      "completion": "<StableToolMessageGenerative>"
    },
    "delayMessageID": "<string>",
    "failureMessageID": "<string>",
    "executionMessageID": "<string>",
    "completionMessageID": "<string>",
    "delayMessageSeconds": 0
  },
  "toolSound": {
    "ref": "<string>",
    "volume": 0.75
  },
  "captureInputVariables": {},
  "type": "api",
  "asyncExecution": true,
  "inputVariables": {},
  "captureResponse": {}
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v2/stable/tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "description": "<string>",
    "messages": {
      "generative": {
        "execution": "<StableToolMessageGenerative>",
        "failure": "<StableToolMessageGenerative>",
        "delay": "<StableToolMessageGenerative>",
        "completion": "<StableToolMessageGenerative>"
      },
      "delayMessageID": "<string>",
      "failureMessageID": "<string>",
      "executionMessageID": "<string>",
      "completionMessageID": "<string>",
      "delayMessageSeconds": 0
    },
    "toolSound": {
      "ref": "<string>",
      "volume": 0.75
    },
    "captureInputVariables": {},
    "type": "api",
    "asyncExecution": true,
    "inputVariables": {},
    "captureResponse": {}
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.patch(
    'https://realtime-api.voiceflow.com/v2/stable/tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "description": "<string>",
      "messages": {
        "generative": {
          "execution": "<StableToolMessageGenerative>",
          "failure": "<StableToolMessageGenerative>",
          "delay": "<StableToolMessageGenerative>",
          "completion": "<StableToolMessageGenerative>"
        },
        "delayMessageID": "<string>",
        "failureMessageID": "<string>",
        "executionMessageID": "<string>",
        "completionMessageID": "<string>",
        "delayMessageSeconds": 0
      },
      "toolSound": {
        "ref": "<string>",
        "volume": 0.75
      },
      "captureInputVariables": {},
      "type": "api",
      "asyncExecution": True,
      "inputVariables": {},
      "captureResponse": {}
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf tool update --tool-id <toolID> --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "description": "<string>",
  "messages": {
    "generative": {
      "execution": "<StableToolMessageGenerative>",
      "failure": "<StableToolMessageGenerative>",
      "delay": "<StableToolMessageGenerative>",
      "completion": "<StableToolMessageGenerative>"
    },
    "delayMessageID": "<string>",
    "failureMessageID": "<string>",
    "executionMessageID": "<string>",
    "completionMessageID": "<string>",
    "delayMessageSeconds": 0
  },
  "toolSound": {
    "ref": "<string>",
    "volume": 0.75
  },
  "captureInputVariables": {},
  "type": "api",
  "asyncExecution": true,
  "inputVariables": {},
  "captureResponse": {}
}
JSON
```


## Delete tool

Deletes a single tool by ID, including a workflow tool. A tool is something a playbook can call during a conversation. The response carries only a confirmation message, so refetch the tools to see what is left.

### Endpoint

```http
DELETE /v2/stable/tool/{toolID}
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `toolID`

Required · string

The ID of the tool to operate on.

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

#### `type`

Required · enum<string>

The type of the tool to delete. `workflow` removes a workflow tool; the workflow stays.

```json
{
  "type": "string",
  "enum": [
    "api",
    "mcp",
    "function",
    "integration",
    "workflow"
  ],
  "description": "The type of the tool to delete. `workflow` removes a workflow tool; the workflow stays.",
  "x-enumNames": [
    "API",
    "MCP",
    "FUNCTION",
    "INTEGRATION",
    "WORKFLOW"
  ]
}
```

### Responses

#### 200

Confirms the tool was deleted. The body is a message only, so refetch the agent's or playbook's tools to see what it can still call.

Schema:

```json
{
  "$ref": "#/components/schemas/StableDeleteResponse"
}
```

Example:

```json
{
  "message": "<string>"
}
```

### Request examples

#### cURL

```bash
curl --request DELETE \
  --url 'https://realtime-api.voiceflow.com/v2/stable/tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>&type=<type>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v2/stable/tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>&type=<type>', {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.delete(
    'https://realtime-api.voiceflow.com/v2/stable/tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>&type=<type>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf tool delete --tool-id <toolID> --project-id <projectID> --environment-alias <environmentAlias> --type <type>
```


## Move tool

Move a tool attachment to the agent or to a playbook. It keeps its ID, its fields and its messages.

### Endpoint

```http
POST /v1/stable/tool/{toolID}/move
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `toolID`

Required · string



```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Request body

Required

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StableToolMoveRequest"
      }
    }
  }
}
```

### Responses

#### 200

Schema:

```json
{
  "$ref": "#/components/schemas/StableToolMoveResponse"
}
```

Example:

```json
{
  "tool": {
    "id": "<string>",
    "createdAt": "2026-09-10T00:00:00.000Z",
    "updatedAt": "2026-09-10T00:00:00.000Z",
    "messages": "<StableToolMessages>",
    "toolSound": "<ToolNodeDataToolSound>",
    "description": "<string>",
    "captureInputVariables": {},
    "type": "api",
    "apiToolID": "<string>",
    "asyncExecution": true,
    "inputVariables": {},
    "captureResponse": {}
  }
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/tool/<toolID>/move?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "api",
  "target": {
    "global": true,
    "playbookID": "<string>"
  }
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/tool/<toolID>/move?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "api",
    "target": {
      "global": true,
      "playbookID": "<string>"
    }
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/tool/<toolID>/move?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "type": "api",
      "target": {
        "global": True,
        "playbookID": "<string>"
      }
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf tool move --tool-id <toolID> --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "type": "api",
  "target": {
    "global": true,
    "playbookID": "<string>"
  }
}
JSON
```


## Schema definitions

### AgentToolCaptureInputVariable

```json
{
  "type": "object",
  "properties": {
    "variableOrEntityID": {
      "nullable": true,
      "type": "string"
    },
    "captureType": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ToolNodeCaptureType"
        }
      ]
    }
  },
  "required": [
    "variableOrEntityID"
  ]
}
```

### DefaultValueString

```json
{
  "type": "string",
  "description": "Plain text resolved at runtime and never shown to a model. {variable_name} inserts a variable or entity, {secret_name} a project secret, {variable_name.path} a field of a variable. Escape a literal { or \\ with a backslash. When a name is both a variable and a secret, the secret wins. A name matching none is stored as literal text and reported in unresolvedReferences. Where the field is sent to an upstream system, an unresolved placeholder may be sent as literal text; on an MCP server it is re-resolved by name at connect time, so a literal that matches a real secret binds."
}
```

### MarkdownLikeString

```json
{
  "type": "string",
  "description": "Message text shown to the end user. Limited markdown: **bold**, _italic_, <u>underline</u>, ~~strikethrough~~, [label](url). {variable_name} inserts a variable or entity, {variable_name.path} a field of a variable. Escape a literal { or \\ with a backslash. A name matching neither is stored as literal text and reported in unresolvedReferences; secrets are not available here."
}
```

### StableDeleteResponse

```json
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "A human-readable message confirming the deletion."
    }
  },
  "required": [
    "message"
  ]
}
```

### StableRequiredVariable

```json
{
  "type": "object",
  "properties": {
    "variableOrEntityID": {
      "nullable": true,
      "description": "The ID of the variable or entity the model must fill, or null when the stored row names neither.",
      "type": "string"
    },
    "description": {
      "nullable": true,
      "description": "What the model is told to collect, or null.",
      "type": "string"
    }
  },
  "required": [
    "variableOrEntityID",
    "description"
  ]
}
```

### StableRequiredVariableInput

```json
{
  "type": "object",
  "properties": {
    "variableOrEntityID": {
      "type": "string",
      "minLength": 1,
      "description": "The ID of a variable or an entity in this environment. List each one once."
    },
    "description": {
      "default": null,
      "description": "What the model is told to collect. Leave it out for none.",
      "nullable": true,
      "type": "string"
    }
  },
  "required": [
    "variableOrEntityID"
  ],
  "additionalProperties": false
}
```

### StableTextUpdateResponse

```json
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "A human-readable message confirming the update."
    },
    "unresolvedReferences": {
      "description": "References this write kept as literal text instead of binding, each with the reason. The write still succeeded.",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableUnresolvedReference"
      }
    }
  },
  "required": [
    "message"
  ]
}
```

### StableToolAttachmentV2

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "api"
          ],
          "description": "Discriminator indicating this tool executes a saved API request.",
          "x-enumNames": [
            "API"
          ]
        },
        "apiToolID": {
          "type": "string",
          "description": "The ID of the API resource this tool executes."
        },
        "asyncExecution": {
          "type": "boolean",
          "description": "When enabled, the tool runs in the background without blocking the conversation."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "apiToolInputVariableID": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "apiToolInputVariableID",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataAPICaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "apiToolID",
        "asyncExecution",
        "inputVariables",
        "captureResponse"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "function"
          ],
          "description": "Discriminator indicating this tool executes a custom function.",
          "x-enumNames": [
            "FUNCTION"
          ]
        },
        "functionID": {
          "type": "string",
          "description": "The ID of the function resource this tool executes."
        },
        "asyncExecution": {
          "type": "boolean",
          "description": "When enabled, the tool runs in the background without blocking the conversation."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "functionInputVariableID": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "functionInputVariableID",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataFunctionCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "functionID",
        "asyncExecution",
        "inputVariables",
        "captureResponse"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "mcp"
          ],
          "description": "Discriminator indicating this tool calls a tool from an MCP server.",
          "x-enumNames": [
            "MCP"
          ]
        },
        "mcpToolID": {
          "type": "string",
          "description": "The ID of the MCP tool resource this tool calls."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "mcpIntegrationVariableName": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "mcpIntegrationVariableName",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataMcpIntegrationCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "mcpToolID",
        "inputVariables",
        "captureResponse"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "integration"
          ],
          "description": "Discriminator indicating this tool calls a connected first-party integration.",
          "x-enumNames": [
            "INTEGRATION"
          ]
        },
        "integrationToolID": {
          "type": "string",
          "description": "The ID of the integration tool resource this tool calls."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "integrationToolVariableName": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "integrationToolVariableName",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataIntegrationCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        },
        "extendedInputVariables": {
          "nullable": true,
          "description": "The refined schema of nested inputs the editor stores for some integrations, keyed by input. Copy it as read; null when there is none.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolExtendedInputVariable"
          }
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "integrationToolID",
        "inputVariables",
        "captureResponse",
        "extendedInputVariables"
      ]
    },
    {
      "$ref": "#/components/schemas/StableWorkflowTool"
    }
  ]
}
```

### StableToolCreateManyRequestV2

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "api"
          ],
          "description": "Discriminator indicating that API tools are being created.",
          "x-enumNames": [
            "API"
          ]
        },
        "target": {
          "$ref": "#/components/schemas/StableToolTarget"
        },
        "tools": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "description": {
                "nullable": true,
                "description": "A description of what the tool does, used by the agent to decide when to call it.",
                "type": "string"
              },
              "messages": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/StableToolMessages"
                  }
                ]
              },
              "captureInputVariables": {
                "default": {},
                "nullable": true,
                "description": "A map of tool input names to the variables or entities whose values are captured into them.",
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
                }
              },
              "toolSound": {
                "default": null,
                "nullable": true,
                "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeDataToolSound"
                  }
                ]
              },
              "asyncExecution": {
                "default": false,
                "description": "When enabled, the tool runs in the background without blocking the conversation.",
                "type": "boolean"
              },
              "inputVariables": {
                "default": {},
                "type": "object",
                "additionalProperties": {
                  "type": "object",
                  "properties": {
                    "description": {
                      "default": null,
                      "nullable": true,
                      "type": "string"
                    },
                    "defaultValue": {
                      "default": null,
                      "nullable": true,
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/DefaultValueString"
                        }
                      ]
                    },
                    "apiToolInputVariableID": {
                      "type": "string"
                    },
                    "captureType": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/ToolNodeCaptureType"
                        }
                      ]
                    },
                    "required": {
                      "type": "boolean",
                      "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
                    }
                  },
                  "required": [
                    "apiToolInputVariableID"
                  ]
                }
              },
              "captureResponse": {
                "default": {},
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/ToolNodeDataAPICaptureResponse"
                },
                "description": "A map of variable names to the parts of the tool response captured into them."
              },
              "apiToolID": {
                "type": "string",
                "description": "The ID of the API resource this tool executes."
              }
            },
            "required": [
              "apiToolID"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "type",
        "target",
        "tools"
      ]
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "function"
          ],
          "description": "Discriminator indicating that function tools are being created.",
          "x-enumNames": [
            "FUNCTION"
          ]
        },
        "target": {
          "$ref": "#/components/schemas/StableToolTarget"
        },
        "tools": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "description": {
                "nullable": true,
                "description": "A description of what the tool does, used by the agent to decide when to call it.",
                "type": "string"
              },
              "messages": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/StableToolMessages"
                  }
                ]
              },
              "captureInputVariables": {
                "default": {},
                "nullable": true,
                "description": "A map of tool input names to the variables or entities whose values are captured into them.",
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
                }
              },
              "toolSound": {
                "default": null,
                "nullable": true,
                "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeDataToolSound"
                  }
                ]
              },
              "asyncExecution": {
                "default": false,
                "description": "When enabled, the tool runs in the background without blocking the conversation.",
                "type": "boolean"
              },
              "inputVariables": {
                "default": {},
                "type": "object",
                "additionalProperties": {
                  "type": "object",
                  "properties": {
                    "description": {
                      "default": null,
                      "nullable": true,
                      "type": "string"
                    },
                    "defaultValue": {
                      "default": null,
                      "nullable": true,
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/DefaultValueString"
                        }
                      ]
                    },
                    "functionInputVariableID": {
                      "type": "string"
                    },
                    "captureType": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/ToolNodeCaptureType"
                        }
                      ]
                    },
                    "required": {
                      "type": "boolean",
                      "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
                    }
                  },
                  "required": [
                    "functionInputVariableID"
                  ]
                }
              },
              "captureResponse": {
                "default": {},
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/ToolNodeDataFunctionCaptureResponse"
                },
                "description": "A map of variable names to the parts of the tool response captured into them."
              },
              "functionID": {
                "type": "string",
                "description": "The ID of the function resource this tool executes."
              }
            },
            "required": [
              "functionID"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "type",
        "target",
        "tools"
      ]
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "mcp"
          ],
          "description": "Discriminator indicating that MCP tools are being created.",
          "x-enumNames": [
            "MCP"
          ]
        },
        "target": {
          "$ref": "#/components/schemas/StableToolTarget"
        },
        "tools": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "description": {
                "nullable": true,
                "description": "A description of what the tool does, used by the agent to decide when to call it.",
                "type": "string"
              },
              "messages": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/StableToolMessages"
                  }
                ]
              },
              "captureInputVariables": {
                "default": {},
                "nullable": true,
                "description": "A map of tool input names to the variables or entities whose values are captured into them.",
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
                }
              },
              "toolSound": {
                "default": null,
                "nullable": true,
                "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeDataToolSound"
                  }
                ]
              },
              "inputVariables": {
                "default": {},
                "type": "object",
                "additionalProperties": {
                  "type": "object",
                  "properties": {
                    "description": {
                      "default": null,
                      "nullable": true,
                      "type": "string"
                    },
                    "defaultValue": {
                      "default": null,
                      "nullable": true,
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/DefaultValueString"
                        }
                      ]
                    },
                    "mcpIntegrationVariableName": {
                      "type": "string"
                    },
                    "captureType": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/ToolNodeCaptureType"
                        }
                      ]
                    },
                    "required": {
                      "type": "boolean",
                      "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
                    }
                  },
                  "required": [
                    "mcpIntegrationVariableName"
                  ]
                }
              },
              "captureResponse": {
                "default": {},
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/ToolNodeDataMcpIntegrationCaptureResponse"
                },
                "description": "A map of variable names to the parts of the tool response captured into them."
              },
              "mcpToolID": {
                "type": "string",
                "description": "The ID of the MCP tool resource this tool calls."
              }
            },
            "required": [
              "mcpToolID"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "type",
        "target",
        "tools"
      ]
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "integration"
          ],
          "description": "Discriminator indicating that integration tools are being created.",
          "x-enumNames": [
            "INTEGRATION"
          ]
        },
        "target": {
          "$ref": "#/components/schemas/StableToolTarget"
        },
        "tools": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "description": {
                "nullable": true,
                "description": "A description of what the tool does, used by the agent to decide when to call it.",
                "type": "string"
              },
              "messages": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/StableToolMessages"
                  }
                ]
              },
              "captureInputVariables": {
                "default": {},
                "nullable": true,
                "description": "A map of tool input names to the variables or entities whose values are captured into them.",
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
                }
              },
              "toolSound": {
                "default": null,
                "nullable": true,
                "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeDataToolSound"
                  }
                ]
              },
              "inputVariables": {
                "default": {},
                "type": "object",
                "additionalProperties": {
                  "type": "object",
                  "properties": {
                    "description": {
                      "default": null,
                      "nullable": true,
                      "type": "string"
                    },
                    "defaultValue": {
                      "default": null,
                      "nullable": true,
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/DefaultValueString"
                        }
                      ]
                    },
                    "integrationToolVariableName": {
                      "type": "string"
                    },
                    "captureType": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/ToolNodeCaptureType"
                        }
                      ]
                    },
                    "required": {
                      "type": "boolean",
                      "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
                    }
                  },
                  "required": [
                    "integrationToolVariableName"
                  ]
                }
              },
              "captureResponse": {
                "default": {},
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/ToolNodeDataIntegrationCaptureResponse"
                },
                "description": "A map of variable names to the parts of the tool response captured into them."
              },
              "extendedInputVariables": {
                "default": null,
                "nullable": true,
                "description": "The refined schema of nested inputs the editor stores for some integrations, keyed by input. Copy it as read; null when there is none.",
                "type": "object",
                "additionalProperties": {
                  "$ref": "#/components/schemas/ToolExtendedInputVariable"
                }
              },
              "integrationToolID": {
                "type": "string",
                "description": "The ID of the integration tool resource this tool calls."
              }
            },
            "required": [
              "integrationToolID"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "type",
        "target",
        "tools"
      ]
    }
  ]
}
```

### StableToolCreateManyResponse

```json
{
  "type": "object",
  "properties": {
    "tools": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableToolV2"
      }
    },
    "unresolvedReferences": {
      "description": "References this write kept as literal text instead of binding, each with the reason. The write still succeeded.",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableUnresolvedReference"
      }
    }
  },
  "required": [
    "tools"
  ]
}
```

### StableToolCreateRequestV2

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "target": {
          "$ref": "#/components/schemas/StableToolTarget"
        },
        "messages": {
          "default": null,
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "captureInputVariables": {
          "default": {},
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "toolSound": {
          "default": null,
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "asyncExecution": {
          "default": false,
          "description": "When enabled, the tool runs in the background without blocking the conversation.",
          "type": "boolean"
        },
        "inputVariables": {
          "default": {},
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "apiToolInputVariableID": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "apiToolInputVariableID"
            ]
          }
        },
        "captureResponse": {
          "default": {},
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataAPICaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        },
        "type": {
          "type": "string",
          "enum": [
            "api"
          ],
          "description": "Discriminator indicating this tool executes a saved API request.",
          "x-enumNames": [
            "API"
          ]
        },
        "apiToolID": {
          "type": "string",
          "description": "The ID of the API resource this tool executes."
        }
      },
      "required": [
        "target",
        "type",
        "apiToolID"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "target": {
          "$ref": "#/components/schemas/StableToolTarget"
        },
        "messages": {
          "default": null,
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "captureInputVariables": {
          "default": {},
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "toolSound": {
          "default": null,
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "asyncExecution": {
          "default": false,
          "description": "When enabled, the tool runs in the background without blocking the conversation.",
          "type": "boolean"
        },
        "inputVariables": {
          "default": {},
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "functionInputVariableID": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "functionInputVariableID"
            ]
          }
        },
        "captureResponse": {
          "default": {},
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataFunctionCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        },
        "type": {
          "type": "string",
          "enum": [
            "function"
          ],
          "description": "Discriminator indicating this tool executes a custom function.",
          "x-enumNames": [
            "FUNCTION"
          ]
        },
        "functionID": {
          "type": "string",
          "description": "The ID of the function resource this tool executes."
        }
      },
      "required": [
        "target",
        "type",
        "functionID"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "target": {
          "$ref": "#/components/schemas/StableToolTarget"
        },
        "messages": {
          "default": null,
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "captureInputVariables": {
          "default": {},
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "toolSound": {
          "default": null,
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "inputVariables": {
          "default": {},
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "mcpIntegrationVariableName": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "mcpIntegrationVariableName"
            ]
          }
        },
        "captureResponse": {
          "default": {},
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataMcpIntegrationCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        },
        "type": {
          "type": "string",
          "enum": [
            "mcp"
          ],
          "description": "Discriminator indicating this tool calls a tool from an MCP server.",
          "x-enumNames": [
            "MCP"
          ]
        },
        "mcpToolID": {
          "type": "string",
          "description": "The ID of the MCP tool resource this tool calls."
        }
      },
      "required": [
        "target",
        "type",
        "mcpToolID"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "target": {
          "$ref": "#/components/schemas/StableToolTarget"
        },
        "messages": {
          "default": null,
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "captureInputVariables": {
          "default": {},
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "toolSound": {
          "default": null,
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "inputVariables": {
          "default": {},
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "integrationToolVariableName": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "integrationToolVariableName"
            ]
          }
        },
        "captureResponse": {
          "default": {},
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataIntegrationCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        },
        "extendedInputVariables": {
          "default": null,
          "nullable": true,
          "description": "The refined schema of nested inputs the editor stores for some integrations, keyed by input. Copy it as read; null when there is none.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolExtendedInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "integration"
          ],
          "description": "Discriminator indicating this tool calls a connected first-party integration.",
          "x-enumNames": [
            "INTEGRATION"
          ]
        },
        "integrationToolID": {
          "type": "string",
          "description": "The ID of the integration tool resource this tool calls."
        }
      },
      "required": [
        "target",
        "type",
        "integrationToolID"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "workflow"
          ],
          "description": "Give the agent a tool that runs a workflow. Send target: { global: true }; playbooks take none.",
          "x-enumNames": [
            "WORKFLOW"
          ]
        },
        "target": {
          "$ref": "#/components/schemas/StableToolTarget"
        },
        "workflowID": {
          "type": "string",
          "description": "The workflow to attach, from voiceflow_workflow.list."
        },
        "description": {
          "description": "When the agent should run the workflow. Omit it to use the workflow's own description.",
          "nullable": true,
          "type": "string"
        },
        "requiredVariables": {
          "default": [],
          "description": "The variables or entities the model must fill when it calls the tool. Leave it out for none.",
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/StableRequiredVariableInput"
          }
        }
      },
      "required": [
        "type",
        "target",
        "workflowID"
      ],
      "additionalProperties": false
    }
  ]
}
```

### StableToolListItemV2

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "api"
          ],
          "description": "Discriminator indicating this tool executes a saved API request.",
          "x-enumNames": [
            "API"
          ]
        },
        "apiToolID": {
          "type": "string",
          "description": "The ID of the API resource this tool executes."
        },
        "asyncExecution": {
          "type": "boolean",
          "description": "When enabled, the tool runs in the background without blocking the conversation."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "apiToolInputVariableID": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "apiToolInputVariableID",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataAPICaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "apiToolID",
        "asyncExecution",
        "inputVariables",
        "captureResponse"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "function"
          ],
          "description": "Discriminator indicating this tool executes a custom function.",
          "x-enumNames": [
            "FUNCTION"
          ]
        },
        "functionID": {
          "type": "string",
          "description": "The ID of the function resource this tool executes."
        },
        "asyncExecution": {
          "type": "boolean",
          "description": "When enabled, the tool runs in the background without blocking the conversation."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "functionInputVariableID": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "functionInputVariableID",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataFunctionCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "functionID",
        "asyncExecution",
        "inputVariables",
        "captureResponse"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "mcp"
          ],
          "description": "Discriminator indicating this tool calls a tool from an MCP server.",
          "x-enumNames": [
            "MCP"
          ]
        },
        "mcpToolID": {
          "type": "string",
          "description": "The ID of the MCP tool resource this tool calls."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "mcpIntegrationVariableName": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "mcpIntegrationVariableName",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataMcpIntegrationCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "mcpToolID",
        "inputVariables",
        "captureResponse"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "integration"
          ],
          "description": "Discriminator indicating this tool calls a connected first-party integration.",
          "x-enumNames": [
            "INTEGRATION"
          ]
        },
        "integrationToolID": {
          "type": "string",
          "description": "The ID of the integration tool resource this tool calls."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "integrationToolVariableName": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "integrationToolVariableName",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataIntegrationCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "integrationToolID",
        "inputVariables",
        "captureResponse"
      ]
    },
    {
      "$ref": "#/components/schemas/StableWorkflowTool"
    }
  ]
}
```

### StableToolListResponseV2

```json
{
  "type": "object",
  "properties": {
    "tools": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableToolListItemV2"
      }
    }
  },
  "required": [
    "tools"
  ]
}
```

### StableToolMessageGenerative

```json
{
  "type": "object",
  "properties": {
    "enabled": {
      "type": "boolean"
    },
    "examples": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/MarkdownLikeString"
      }
    }
  },
  "required": [
    "enabled"
  ]
}
```

### StableToolMessages

```json
{
  "type": "object",
  "properties": {
    "generative": {
      "type": "object",
      "properties": {
        "execution": {
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessageGenerative"
            }
          ]
        },
        "failure": {
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessageGenerative"
            }
          ]
        },
        "delay": {
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessageGenerative"
            }
          ]
        },
        "completion": {
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessageGenerative"
            }
          ]
        }
      }
    },
    "delayMessageID": {
      "nullable": true,
      "type": "string"
    },
    "failureMessageID": {
      "nullable": true,
      "type": "string"
    },
    "executionMessageID": {
      "nullable": true,
      "type": "string"
    },
    "completionMessageID": {
      "nullable": true,
      "type": "string"
    },
    "delayMessageSeconds": {
      "nullable": true,
      "type": "number"
    }
  },
  "required": [
    "delayMessageID",
    "failureMessageID",
    "executionMessageID",
    "completionMessageID",
    "delayMessageSeconds"
  ]
}
```

### StableToolMoveRequest

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "api",
        "mcp",
        "function",
        "integration",
        "workflow"
      ],
      "description": "The type of the tool to move. `workflow` is refused: a workflow tool stays on the agent.",
      "x-enumNames": [
        "API",
        "MCP",
        "FUNCTION",
        "INTEGRATION",
        "WORKFLOW"
      ]
    },
    "target": {
      "$ref": "#/components/schemas/StableToolTarget"
    }
  },
  "required": [
    "type",
    "target"
  ],
  "additionalProperties": false
}
```

### StableToolMoveResponse

```json
{
  "type": "object",
  "properties": {
    "tool": {
      "$ref": "#/components/schemas/StableToolV2"
    }
  },
  "required": [
    "tool"
  ]
}
```

### StableToolReadResponse

```json
{
  "type": "object",
  "properties": {
    "tool": {
      "$ref": "#/components/schemas/StableToolAttachmentV2"
    }
  },
  "required": [
    "tool"
  ]
}
```

### StableToolResponseV2

```json
{
  "type": "object",
  "properties": {
    "tool": {
      "$ref": "#/components/schemas/StableToolAttachmentV2"
    },
    "unresolvedReferences": {
      "description": "References this write kept as literal text instead of binding, each with the reason. The write still succeeded.",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableUnresolvedReference"
      }
    }
  },
  "required": [
    "tool"
  ]
}
```

### StableToolTarget

```json
{
  "type": "object",
  "properties": {
    "global": {
      "description": "Target the agent. Cannot be used with playbookID.",
      "type": "boolean"
    },
    "playbookID": {
      "description": "Target a specific playbook. Cannot be used with global.",
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

### StableToolUpdateRequestV2

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs. Replaces the stored one; null removes it; leave it out to keep it.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed. Null for the whole map removes every entry.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
              }
            ]
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "api"
          ],
          "description": "Discriminator indicating this tool executes a saved API request.",
          "x-enumNames": [
            "API"
          ]
        },
        "asyncExecution": {
          "type": "boolean",
          "description": "When enabled, the tool runs in the background without blocking the conversation."
        },
        "inputVariables": {
          "description": "A map of input names to the values the agent supplies when calling the tool. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "apiToolInputVariableID": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "apiToolInputVariableID"
            ]
          }
        },
        "captureResponse": {
          "description": "A map of variable names to the parts of the tool response captured into them. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/ToolNodeDataAPICaptureResponse"
              }
            ]
          }
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs. Replaces the stored one; null removes it; leave it out to keep it.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed. Null for the whole map removes every entry.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
              }
            ]
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "function"
          ],
          "description": "Discriminator indicating this tool executes a custom function.",
          "x-enumNames": [
            "FUNCTION"
          ]
        },
        "asyncExecution": {
          "type": "boolean",
          "description": "When enabled, the tool runs in the background without blocking the conversation."
        },
        "inputVariables": {
          "description": "A map of input names to the values the agent supplies when calling the tool. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "functionInputVariableID": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "functionInputVariableID"
            ]
          }
        },
        "captureResponse": {
          "description": "A map of variable names to the parts of the tool response captured into them. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/ToolNodeDataFunctionCaptureResponse"
              }
            ]
          }
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs. Replaces the stored one; null removes it; leave it out to keep it.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed. Null for the whole map removes every entry.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
              }
            ]
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "mcp"
          ],
          "description": "Discriminator indicating this tool calls a tool from an MCP server.",
          "x-enumNames": [
            "MCP"
          ]
        },
        "inputVariables": {
          "description": "A map of input names to the values the agent supplies when calling the tool. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "mcpIntegrationVariableName": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "mcpIntegrationVariableName"
            ]
          }
        },
        "captureResponse": {
          "description": "A map of variable names to the parts of the tool response captured into them. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/ToolNodeDataMcpIntegrationCaptureResponse"
              }
            ]
          }
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs. Replaces the stored one; null removes it; leave it out to keep it.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed. Null for the whole map removes every entry.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
              }
            ]
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "integration"
          ],
          "description": "Discriminator indicating this tool calls a connected first-party integration.",
          "x-enumNames": [
            "INTEGRATION"
          ]
        },
        "inputVariables": {
          "description": "A map of input names to the values the agent supplies when calling the tool. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "integrationToolVariableName": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "integrationToolVariableName"
            ]
          }
        },
        "captureResponse": {
          "description": "A map of variable names to the parts of the tool response captured into them. Merged into the stored map by key: an entry you send replaces that entry, an entry you leave out stays, and an entry sent as null is removed.",
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/ToolNodeDataIntegrationCaptureResponse"
              }
            ]
          }
        },
        "extendedInputVariables": {
          "description": "Replaces the stored map whole; null removes it; leave it out to keep it.",
          "nullable": true,
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolExtendedInputVariable"
          }
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    }
  ]
}
```

### StableToolV2

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "api"
          ],
          "description": "Discriminator indicating this tool executes a saved API request.",
          "x-enumNames": [
            "API"
          ]
        },
        "apiToolID": {
          "type": "string",
          "description": "The ID of the API resource this tool executes."
        },
        "asyncExecution": {
          "type": "boolean",
          "description": "When enabled, the tool runs in the background without blocking the conversation."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "apiToolInputVariableID": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "apiToolInputVariableID",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataAPICaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "apiToolID",
        "asyncExecution",
        "inputVariables",
        "captureResponse"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "function"
          ],
          "description": "Discriminator indicating this tool executes a custom function.",
          "x-enumNames": [
            "FUNCTION"
          ]
        },
        "functionID": {
          "type": "string",
          "description": "The ID of the function resource this tool executes."
        },
        "asyncExecution": {
          "type": "boolean",
          "description": "When enabled, the tool runs in the background without blocking the conversation."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "functionInputVariableID": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "functionInputVariableID",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataFunctionCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "functionID",
        "asyncExecution",
        "inputVariables",
        "captureResponse"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "mcp"
          ],
          "description": "Discriminator indicating this tool calls a tool from an MCP server.",
          "x-enumNames": [
            "MCP"
          ]
        },
        "mcpToolID": {
          "type": "string",
          "description": "The ID of the MCP tool resource this tool calls."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "mcpIntegrationVariableName": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "mcpIntegrationVariableName",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataMcpIntegrationCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "mcpToolID",
        "inputVariables",
        "captureResponse"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "messages": {
          "nullable": true,
          "allOf": [
            {
              "$ref": "#/components/schemas/StableToolMessages"
            }
          ]
        },
        "toolSound": {
          "nullable": true,
          "description": "The sound played while the tool runs, as the editor sets it, or null for none.",
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolNodeDataToolSound"
            }
          ]
        },
        "description": {
          "nullable": true,
          "description": "A description of what the tool does, used by the agent to decide when to call it.",
          "type": "string"
        },
        "captureInputVariables": {
          "nullable": true,
          "description": "A map of tool input names to the variables or entities whose values are captured into them.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/AgentToolCaptureInputVariable"
          }
        },
        "type": {
          "type": "string",
          "enum": [
            "integration"
          ],
          "description": "Discriminator indicating this tool calls a connected first-party integration.",
          "x-enumNames": [
            "INTEGRATION"
          ]
        },
        "integrationToolID": {
          "type": "string",
          "description": "The ID of the integration tool resource this tool calls."
        },
        "inputVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "description": {
                "default": null,
                "nullable": true,
                "type": "string"
              },
              "defaultValue": {
                "default": null,
                "nullable": true,
                "allOf": [
                  {
                    "$ref": "#/components/schemas/DefaultValueString"
                  }
                ]
              },
              "integrationToolVariableName": {
                "type": "string"
              },
              "captureType": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ToolNodeCaptureType"
                  }
                ]
              },
              "required": {
                "type": "boolean",
                "description": "Whether the agent must supply a value for this input. Omit it and the API infers: false when defaultValue holds a secret reference (the secret is injected and the model is never asked for it), true otherwise. Sending true together with a secret defaultValue is rejected."
              }
            },
            "required": [
              "integrationToolVariableName",
              "required"
            ]
          },
          "description": "A map of input names to the values the agent supplies when calling the tool."
        },
        "captureResponse": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolNodeDataIntegrationCaptureResponse"
          },
          "description": "A map of variable names to the parts of the tool response captured into them."
        },
        "extendedInputVariables": {
          "nullable": true,
          "description": "The refined schema of nested inputs the editor stores for some integrations, keyed by input. Copy it as read; null when there is none.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/ToolExtendedInputVariable"
          }
        }
      },
      "required": [
        "id",
        "createdAt",
        "updatedAt",
        "messages",
        "toolSound",
        "description",
        "captureInputVariables",
        "type",
        "integrationToolID",
        "inputVariables",
        "captureResponse",
        "extendedInputVariables"
      ]
    }
  ]
}
```

### StableUnresolvedReference

```json
{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Dotted path of the field that carried it, e.g. `knowledgeBaseTool.filters[0].defaultValue`."
    },
    "token": {
      "type": "string",
      "description": "The reference as written, without braces."
    },
    "reason": {
      "type": "string",
      "enum": [
        "unknown",
        "secret-not-allowed",
        "path-on-non-variable",
        "resource-id",
        "invalid-name",
        "dangling"
      ],
      "description": "`unknown`: no variable or entity of that name. `secret-not-allowed`: the name is a project secret and this field does not accept one. `path-on-non-variable`: only a variable has fields. `resource-id`: a bare resource id, not a name. `invalid-name`: outside the `^\\w{1,64}$` name grammar. `dangling`: the reference rendered as a bare id, because its row is gone or its name is outside the name grammar.",
      "x-enumNames": [
        "UNKNOWN",
        "SECRET_NOT_ALLOWED",
        "PATH_ON_NON_VARIABLE",
        "RESOURCE_ID",
        "INVALID_NAME",
        "DANGLING"
      ]
    }
  },
  "required": [
    "path",
    "token",
    "reason"
  ]
}
```

### StableWorkflowTool

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "workflow"
      ],
      "description": "Discriminator indicating a workflow the agent can run as a tool.",
      "x-enumNames": [
        "WORKFLOW"
      ]
    },
    "workflowID": {
      "type": "string",
      "description": "The workflow the tool runs."
    },
    "description": {
      "nullable": true,
      "description": "When the agent should run the workflow; null uses the workflow's own.",
      "type": "string"
    },
    "requiredVariables": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableRequiredVariable"
      },
      "description": "The variables or entities the model must fill when it calls the tool, in the order they were added, oldest first. The editor lists them newest first."
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "required": [
    "id",
    "type",
    "workflowID",
    "description",
    "requiredVariables",
    "createdAt",
    "updatedAt"
  ]
}
```

### ToolExtendedInputVariable

```json
{
  "type": "object",
  "properties": {
    "schema": {},
    "metadata": {
      "type": "object",
      "additionalProperties": {}
    },
    "draft": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ToolExtendedInputVariableSlot"
        }
      ]
    }
  }
}
```

### ToolExtendedInputVariableSlot

```json
{
  "type": "object",
  "properties": {
    "schema": {},
    "metadata": {
      "type": "object",
      "additionalProperties": {}
    }
  }
}
```

### ToolNodeCaptureType

```json
{
  "type": "string",
  "enum": [
    "variable",
    "property"
  ],
  "x-enumNames": [
    "VARIABLE",
    "PROPERTY"
  ]
}
```

### ToolNodeDataAPICaptureResponse

```json
{
  "type": "object",
  "properties": {
    "path": {
      "type": "string"
    },
    "variableOrEntityID": {
      "nullable": true,
      "type": "string"
    },
    "captureType": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ToolNodeCaptureType"
        }
      ]
    }
  },
  "required": [
    "path",
    "variableOrEntityID"
  ]
}
```

### ToolNodeDataFunctionCaptureResponse

```json
{
  "type": "object",
  "properties": {
    "variableOrEntityID": {
      "nullable": true,
      "type": "string"
    },
    "functionOutputVariableID": {
      "type": "string"
    },
    "captureType": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ToolNodeCaptureType"
        }
      ]
    }
  },
  "required": [
    "variableOrEntityID",
    "functionOutputVariableID"
  ]
}
```

### ToolNodeDataIntegrationCaptureResponse

```json
{
  "type": "object",
  "properties": {
    "path": {
      "type": "string"
    },
    "variableOrEntityID": {
      "nullable": true,
      "type": "string"
    },
    "captureType": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ToolNodeCaptureType"
        }
      ]
    }
  },
  "required": [
    "path",
    "variableOrEntityID"
  ]
}
```

### ToolNodeDataMcpIntegrationCaptureResponse

```json
{
  "type": "object",
  "properties": {
    "path": {
      "type": "string"
    },
    "variableOrEntityID": {
      "nullable": true,
      "type": "string"
    },
    "captureType": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ToolNodeCaptureType"
        }
      ]
    }
  },
  "required": [
    "path",
    "variableOrEntityID"
  ]
}
```

### ToolNodeDataToolSound

```json
{
  "type": "object",
  "properties": {
    "ref": {
      "nullable": true,
      "type": "string"
    },
    "volume": {
      "default": 0.75,
      "type": "number",
      "minimum": 0,
      "maximum": 1
    }
  },
  "required": [
    "ref"
  ]
}
```
