> ## 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.

# Test Checks

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

API version: Selected per operation

## List checks

Returns every test check in its turn. A test check is one assertion about an agent turn, comparing the reply or the behaviour behind it. The call takes no paging parameters, so one request yields the whole set.

### Endpoint

```http
GET /v1/stable/test-check
```

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`)."
}
```

#### `turnID`

Required · string

The ID of the turn whose checks to list.

```json
{
  "type": "string",
  "description": "The ID of the turn whose checks to list."
}
```

### Responses

#### 200

Returns every check attached to the turn named in `turnID`. Each one asserts on the agent's response text, on whether it routed to a given playbook or workflow, or on whether it called a given tool.

Schema:

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

Example:

```json
{
  "checks": [
    {
      "id": "<string>",
      "turnID": "<string>",
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "type": "response",
      "payload": "<ResponseSimulationTurnTestPayload>"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request GET \
  --url 'https://realtime-api.voiceflow.com/v1/stable/test-check?projectID=<projectID>&environmentAlias=<environmentAlias>&turnID=<turnID>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

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

#### Python

```python
import requests

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

#### Voiceflow CLI

```bash
vf test check list --project-id <projectID> --environment-alias <environmentAlias> --turn-id <turnID>
```


## Create check

Adds a test check to its turn, one assertion about an agent turn, comparing the reply or the behaviour behind it. The response carries the ID that later calls address it by.

### Endpoint

```http
POST /v1/stable/test-check
```

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/StableTestCheckCreateRequest"
      }
    }
  }
}
```

### Responses

#### 201

Creates one check on the turn named in the body and returns it with its assigned `id`. Checks hang off agent turns, which are the turns that carry a `checkOrder`.

Schema:

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

Example:

```json
{
  "check": {
    "id": "<string>",
    "turnID": "<string>",
    "createdAt": "2026-09-10T00:00:00.000Z",
    "updatedAt": "2026-09-10T00:00:00.000Z",
    "type": "response",
    "payload": "<SimulationTurnTestJudgeEqual>"
  }
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/test-check?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "response",
  "turnID": "<string>",
  "payload": {
    "type": "equal",
    "value": "<string>"
  }
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test-check?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "response",
    "turnID": "<string>",
    "payload": {
      "type": "equal",
      "value": "<string>"
    }
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/test-check?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "type": "response",
      "turnID": "<string>",
      "payload": {
        "type": "equal",
        "value": "<string>"
      }
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf test check create --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "type": "response",
  "turnID": "<string>",
  "payload": {
    "type": "equal",
    "value": "<string>"
  }
}
JSON
```


## Create many checks

Adds several test checks to its turn in one request, each taking the fields the single-create call takes. The response carries the created test checks in the same shape the list call returns.

### Endpoint

```http
POST /v1/stable/test-check/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/StableTestCheckCreateManyRequest"
      }
    }
  }
}
```

### Responses

#### 201

Creates every check in the request body against the single turn named there and returns them with their assigned IDs. Types can be mixed in one batch, so a response, a routing, and a tool check can all land on the same turn.

Schema:

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

Example:

```json
{
  "checks": [
    {
      "id": "<string>",
      "turnID": "<string>",
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "type": "response",
      "payload": "<ResponseSimulationTurnTestPayload>"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/test-check/batch?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "turnID": "<string>",
  "checks": [
    {
      "type": "response",
      "payload": "<ResponseSimulationTurnTestPayload>"
    }
  ]
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test-check/batch?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "turnID": "<string>",
    "checks": [
      {
        "type": "response",
        "payload": "<ResponseSimulationTurnTestPayload>"
      }
    ]
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/test-check/batch?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "turnID": "<string>",
      "checks": [
        {
          "type": "response",
          "payload": "<ResponseSimulationTurnTestPayload>"
        }
      ]
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf test check create-many --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "turnID": "<string>",
  "checks": [
    {
      "type": "response",
      "payload": "<ResponseSimulationTurnTestPayload>"
    }
  ]
}
JSON
```


## Get check

Returns a single test check by ID, with the fields that define it. A test check is one assertion about an agent turn, comparing the reply or the behaviour behind it.

### Endpoint

```http
GET /v1/stable/test-check/{checkID}
```

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

### Authentication

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

`token`:

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

### Path parameters

#### `checkID`

Required · string

The ID of the test check 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`)."
}
```

### Responses

#### 200

Returns one check with the `turnID` it belongs to and the payload for its type: the expected string or judge prompt for a response check, the routing target and whether it should be reached, or the tool and whether it should be called.

Schema:

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

Example:

```json
{
  "check": {
    "id": "<string>",
    "turnID": "<string>",
    "createdAt": "2026-09-10T00:00:00.000Z",
    "updatedAt": "2026-09-10T00:00:00.000Z",
    "type": "response",
    "payload": "<SimulationTurnTestJudgeEqual>"
  }
}
```

### Request examples

#### cURL

```bash
curl --request GET \
  --url 'https://realtime-api.voiceflow.com/v1/stable/test-check/<checkID>?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

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

#### Python

```python
import requests

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

#### Voiceflow CLI

```bash
vf test check get --check-id <checkID> --project-id <projectID> --environment-alias <environmentAlias>
```


## Update check

Changes an existing test check in place. The response carries only a confirmation message, so refetch the test check to read its new values.

### Endpoint

```http
PATCH /v1/stable/test-check/{checkID}
```

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

### Authentication

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

`token`:

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

### Path parameters

#### `checkID`

Required · string

The ID of the test check 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/StableTestCheckUpdateRequest"
      }
    }
  }
}
```

### Responses

#### 200

Confirms the check's payload was updated, such as a new judge prompt or a different routing target. The body carries a message only, so read the check back to see what was stored.

Schema:

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

Example:

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

### Request examples

#### cURL

```bash
curl --request PATCH \
  --url 'https://realtime-api.voiceflow.com/v1/stable/test-check/<checkID>?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "response",
  "payload": "<SimulationTurnTestJudgeEqual>"
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test-check/<checkID>?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "response",
    "payload": "<SimulationTurnTestJudgeEqual>"
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.patch(
    'https://realtime-api.voiceflow.com/v1/stable/test-check/<checkID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "type": "response",
      "payload": "<SimulationTurnTestJudgeEqual>"
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf test check update --check-id <checkID> --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "type": "response",
  "payload": "<SimulationTurnTestJudgeEqual>"
}
JSON
```


## Delete check

Deletes a single test check by ID. A test check is one assertion about an agent turn, comparing the reply or the behaviour behind it. The response carries only a confirmation message, so refetch the test checks to see what is left.

### Endpoint

```http
DELETE /v1/stable/test-check/{checkID}
```

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

### Authentication

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

`token`:

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

### Path parameters

#### `checkID`

Required · string

The ID of the test check 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`)."
}
```

### Responses

#### 200

Confirms one assertion was removed from its turn. The body carries a message only, not the turn's remaining checks.

Schema:

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

Example:

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

### Request examples

#### cURL

```bash
curl --request DELETE \
  --url 'https://realtime-api.voiceflow.com/v1/stable/test-check/<checkID>?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

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

#### Python

```python
import requests

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

#### Voiceflow CLI

```bash
vf test check delete --check-id <checkID> --project-id <projectID> --environment-alias <environmentAlias>
```


## Schema definitions

### ApiCallToolSimulationTurnTestPayload

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "api-call"
      ],
      "x-enumNames": [
        "API_CALL"
      ]
    },
    "toolID": {
      "type": "string"
    }
  },
  "required": [
    "type",
    "toolID"
  ]
}
```

### FunctionToolSimulationTurnTestPayload

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "function"
      ],
      "x-enumNames": [
        "FUNCTION"
      ]
    },
    "toolID": {
      "type": "string"
    }
  },
  "required": [
    "type",
    "toolID"
  ]
}
```

### IntegrationToolSimulationTurnTestPayload

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "integration"
      ],
      "x-enumNames": [
        "INTEGRATION"
      ]
    },
    "toolID": {
      "type": "string"
    }
  },
  "required": [
    "type",
    "toolID"
  ]
}
```

### McpIntegrationToolSimulationTurnTestPayload

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "mcp-integration"
      ],
      "x-enumNames": [
        "MCP_INTEGRATION"
      ]
    },
    "toolID": {
      "type": "string"
    }
  },
  "required": [
    "type",
    "toolID"
  ]
}
```

### NativeToolSimulationTurnTestPayload

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "native"
      ],
      "x-enumNames": [
        "NATIVE"
      ]
    },
    "kind": {
      "$ref": "#/components/schemas/SimulationTurnTestToolNativeKind"
    }
  },
  "required": [
    "type",
    "kind"
  ]
}
```

### ResponseSimulationTurnTestPayload

```json
{
  "oneOf": [
    {
      "$ref": "#/components/schemas/SimulationTurnTestJudgeEqual"
    },
    {
      "$ref": "#/components/schemas/SimulationTurnTestJudgeLLMEval"
    }
  ]
}
```

### SimulationTurnTestJudgeEqual

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "equal"
      ],
      "x-enumNames": [
        "EQUAL"
      ]
    },
    "value": {
      "type": "string"
    }
  },
  "required": [
    "type",
    "value"
  ]
}
```

### SimulationTurnTestJudgeLLMEval

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "llm_eval"
      ],
      "x-enumNames": [
        "LLM_EVAL"
      ]
    },
    "prompt": {
      "type": "string"
    }
  },
  "required": [
    "type",
    "prompt"
  ]
}
```

### SimulationTurnTestToolNativeKind

```json
{
  "type": "string",
  "enum": [
    "end",
    "card",
    "button",
    "carousel",
    "skip-turn",
    "web-search",
    "call-forward",
    "knowledge-base"
  ],
  "x-enumNames": [
    "END",
    "CARD",
    "BUTTON",
    "CAROUSEL",
    "SKIP_TURN",
    "WEB_SEARCH",
    "CALL_FORWARD",
    "KNOWLEDGE_BASE"
  ]
}
```

### StableDeleteResponse

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

### StableTestCheck

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "turnID": {
          "type": "string",
          "description": "The ID of the turn this check belongs to."
        },
        "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))$"
        },
        "type": {
          "type": "string",
          "enum": [
            "response"
          ],
          "description": "Identifies a check that judges the agent's response text against expected criteria.",
          "x-enumNames": [
            "RESPONSE"
          ]
        },
        "payload": {
          "$ref": "#/components/schemas/ResponseSimulationTurnTestPayload"
        }
      },
      "required": [
        "id",
        "turnID",
        "createdAt",
        "updatedAt",
        "type",
        "payload"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "turnID": {
          "type": "string",
          "description": "The ID of the turn this check belongs to."
        },
        "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))$"
        },
        "type": {
          "type": "string",
          "enum": [
            "routing"
          ],
          "description": "Identifies a check that verifies whether the agent routed to a specific playbook or workflow.",
          "x-enumNames": [
            "ROUTING"
          ]
        },
        "payload": {
          "type": "object",
          "properties": {
            "routeTo": {
              "nullable": true,
              "description": "The routing target to check against, paired with shouldRoute. Null when asserting no routing at all.",
              "type": "object",
              "properties": {
                "resourceID": {
                  "type": "string",
                  "description": "The ID of the playbook or workflow the check routes against."
                },
                "resourceType": {
                  "type": "string",
                  "enum": [
                    "playbook",
                    "workflow"
                  ],
                  "description": "Whether resourceID is a playbook or a workflow.",
                  "x-enumNames": [
                    "PLAYBOOK",
                    "WORKFLOW"
                  ]
                }
              },
              "required": [
                "resourceID",
                "resourceType"
              ]
            },
            "shouldRoute": {
              "type": "boolean"
            }
          },
          "required": [
            "routeTo",
            "shouldRoute"
          ]
        }
      },
      "required": [
        "id",
        "turnID",
        "createdAt",
        "updatedAt",
        "type",
        "payload"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "turnID": {
          "type": "string",
          "description": "The ID of the turn this check belongs to."
        },
        "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))$"
        },
        "type": {
          "type": "string",
          "enum": [
            "tool"
          ],
          "description": "Identifies a check that verifies whether the agent called a specific tool.",
          "x-enumNames": [
            "TOOL"
          ]
        },
        "payload": {
          "$ref": "#/components/schemas/ToolSimulationTurnTestPayload"
        }
      },
      "required": [
        "id",
        "turnID",
        "createdAt",
        "updatedAt",
        "type",
        "payload"
      ]
    }
  ]
}
```

### StableTestCheckCreateManyRequest

```json
{
  "type": "object",
  "properties": {
    "turnID": {
      "type": "string",
      "description": "The ID of the turn to attach these checks to."
    },
    "checks": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "response"
                ],
                "description": "Identifies a check that judges the agent's response text against expected criteria.",
                "x-enumNames": [
                  "RESPONSE"
                ]
              },
              "payload": {
                "$ref": "#/components/schemas/ResponseSimulationTurnTestPayload"
              }
            },
            "required": [
              "type",
              "payload"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "routing"
                ],
                "description": "Identifies a check that verifies whether the agent routed to a specific playbook or workflow.",
                "x-enumNames": [
                  "ROUTING"
                ]
              },
              "payload": {
                "type": "object",
                "properties": {
                  "routeTo": {
                    "nullable": true,
                    "description": "The routing target to check against, paired with shouldRoute. Null when asserting no routing at all.",
                    "type": "object",
                    "properties": {
                      "resourceID": {
                        "type": "string",
                        "description": "The ID of the playbook or workflow the check routes against."
                      },
                      "resourceType": {
                        "type": "string",
                        "enum": [
                          "playbook",
                          "workflow"
                        ],
                        "description": "Whether resourceID is a playbook or a workflow.",
                        "x-enumNames": [
                          "PLAYBOOK",
                          "WORKFLOW"
                        ]
                      }
                    },
                    "required": [
                      "resourceID",
                      "resourceType"
                    ]
                  },
                  "shouldRoute": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "routeTo",
                  "shouldRoute"
                ]
              }
            },
            "required": [
              "type",
              "payload"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "tool"
                ],
                "description": "Identifies a check that verifies whether the agent called a specific tool.",
                "x-enumNames": [
                  "TOOL"
                ]
              },
              "payload": {
                "$ref": "#/components/schemas/ToolSimulationTurnTestPayload"
              }
            },
            "required": [
              "type",
              "payload"
            ],
            "additionalProperties": false
          }
        ]
      }
    }
  },
  "required": [
    "turnID",
    "checks"
  ]
}
```

### StableTestCheckCreateRequest

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "response"
          ],
          "description": "Identifies a check that judges the agent's response text against expected criteria.",
          "x-enumNames": [
            "RESPONSE"
          ]
        },
        "turnID": {
          "type": "string",
          "description": "The ID of the turn this check belongs to."
        },
        "payload": {
          "$ref": "#/components/schemas/ResponseSimulationTurnTestPayload"
        }
      },
      "required": [
        "type",
        "turnID",
        "payload"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "routing"
          ],
          "description": "Identifies a check that verifies whether the agent routed to a specific playbook or workflow.",
          "x-enumNames": [
            "ROUTING"
          ]
        },
        "turnID": {
          "type": "string",
          "description": "The ID of the turn this check belongs to."
        },
        "payload": {
          "type": "object",
          "properties": {
            "routeTo": {
              "nullable": true,
              "description": "The routing target to check against, paired with shouldRoute. Null when asserting no routing at all.",
              "type": "object",
              "properties": {
                "resourceID": {
                  "type": "string",
                  "description": "The ID of the playbook or workflow the check routes against."
                },
                "resourceType": {
                  "type": "string",
                  "enum": [
                    "playbook",
                    "workflow"
                  ],
                  "description": "Whether resourceID is a playbook or a workflow.",
                  "x-enumNames": [
                    "PLAYBOOK",
                    "WORKFLOW"
                  ]
                }
              },
              "required": [
                "resourceID",
                "resourceType"
              ]
            },
            "shouldRoute": {
              "type": "boolean"
            }
          },
          "required": [
            "routeTo",
            "shouldRoute"
          ]
        }
      },
      "required": [
        "type",
        "turnID",
        "payload"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "tool"
          ],
          "description": "Identifies a check that verifies whether the agent called a specific tool.",
          "x-enumNames": [
            "TOOL"
          ]
        },
        "turnID": {
          "type": "string",
          "description": "The ID of the turn this check belongs to."
        },
        "payload": {
          "$ref": "#/components/schemas/ToolSimulationTurnTestPayload"
        }
      },
      "required": [
        "type",
        "turnID",
        "payload"
      ],
      "additionalProperties": false
    }
  ]
}
```

### StableTestCheckListResponse

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

### StableTestCheckResponse

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

### StableTestCheckUpdateRequest

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "response"
          ],
          "description": "Identifies a check that judges the agent's response text against expected criteria.",
          "x-enumNames": [
            "RESPONSE"
          ]
        },
        "payload": {
          "allOf": [
            {
              "$ref": "#/components/schemas/ResponseSimulationTurnTestPayload"
            }
          ]
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "routing"
          ],
          "description": "Identifies a check that verifies whether the agent routed to a specific playbook or workflow.",
          "x-enumNames": [
            "ROUTING"
          ]
        },
        "payload": {
          "type": "object",
          "properties": {
            "routeTo": {
              "nullable": true,
              "description": "The routing target to check against, paired with shouldRoute. Null when asserting no routing at all.",
              "type": "object",
              "properties": {
                "resourceID": {
                  "type": "string",
                  "description": "The ID of the playbook or workflow the check routes against."
                },
                "resourceType": {
                  "type": "string",
                  "enum": [
                    "playbook",
                    "workflow"
                  ],
                  "description": "Whether resourceID is a playbook or a workflow.",
                  "x-enumNames": [
                    "PLAYBOOK",
                    "WORKFLOW"
                  ]
                }
              },
              "required": [
                "resourceID",
                "resourceType"
              ]
            },
            "shouldRoute": {
              "type": "boolean"
            }
          },
          "required": [
            "routeTo",
            "shouldRoute"
          ]
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "tool"
          ],
          "description": "Identifies a check that verifies whether the agent called a specific tool.",
          "x-enumNames": [
            "TOOL"
          ]
        },
        "payload": {
          "allOf": [
            {
              "$ref": "#/components/schemas/ToolSimulationTurnTestPayload"
            }
          ]
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    }
  ]
}
```

### StableUpdateResponse

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

### ToolSimulationTurnTestPayload

```json
{
  "type": "object",
  "properties": {
    "tool": {
      "nullable": true,
      "allOf": [
        {
          "$ref": "#/components/schemas/ToolSimulationTurnTestPayloadTool"
        }
      ]
    },
    "shouldCall": {
      "type": "boolean"
    }
  },
  "required": [
    "tool",
    "shouldCall"
  ]
}
```

### ToolSimulationTurnTestPayloadTool

```json
{
  "oneOf": [
    {
      "$ref": "#/components/schemas/NativeToolSimulationTurnTestPayload"
    },
    {
      "$ref": "#/components/schemas/ApiCallToolSimulationTurnTestPayload"
    },
    {
      "$ref": "#/components/schemas/FunctionToolSimulationTurnTestPayload"
    },
    {
      "$ref": "#/components/schemas/IntegrationToolSimulationTurnTestPayload"
    },
    {
      "$ref": "#/components/schemas/McpIntegrationToolSimulationTurnTestPayload"
    }
  ]
}
```
