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

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

API version: Selected per operation

## Search runs

Finds past runs of a test, each carrying how many of its checks passed. The body takes `take` and `skip`, so results arrive a page at a time rather than all at once.

### Endpoint

```http
POST /v1/stable/test-run/search
```

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

### Responses

#### 200

Returns the runs matching the search body, each carrying the `testID` it belongs to, its `status`, its check tallies, and the credits it consumed. Set `testID` in the body to narrow to one test's history, or omit it to search every test in the environment.

Schema:

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

Example:

```json
{
  "runs": [
    {
      "id": "<string>",
      "logs": [
        "<SimulationRunLog>"
      ],
      "status": "idle",
      "testID": "<string>",
      "failReason": "<string>",
      "totalChecks": 0,
      "passedChecks": 0,
      "totalCredits": 0,
      "createdAt": "2026-09-10T00:00:00.000Z",
      "startedAt": "2026-09-10T00:00:00.000Z",
      "finishedAt": "2026-09-10T00:00:00.000Z"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/test-run/search?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "take": 20,
  "skip": 0,
  "testID": "<string>"
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test-run/search?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "take": 20,
    "skip": 0,
    "testID": "<string>"
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/test-run/search?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "take": 20,
      "skip": 0,
      "testID": "<string>"
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf test run search --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "take": 20,
  "skip": 0,
  "testID": "<string>"
}
JSON
```


## Create run

Adds a test run to the environment, one execution of a test, carrying how many of its checks passed. The response carries the ID that later calls address it by.

### Endpoint

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

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

### Responses

#### 201

Creates a run of the test named in the body and returns it, possibly still queued: `startedAt` is null until execution begins and `passedChecks` is null until the run finishes. Read the run back by `id` to follow it through to `passed`, `failed`, or `canceled`.

Schema:

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

Example:

```json
{
  "run": {
    "id": "<string>",
    "logs": [
      "<SimulationRunEndLog>"
    ],
    "status": "idle",
    "testID": "<string>",
    "failReason": "<string>",
    "totalChecks": 0,
    "passedChecks": 0,
    "totalCredits": 0,
    "createdAt": "2026-09-10T00:00:00.000Z",
    "startedAt": "2026-09-10T00:00:00.000Z",
    "finishedAt": "2026-09-10T00:00:00.000Z"
  }
}
```

### Request examples

#### cURL

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

#### JavaScript

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

#### Python

```python
import requests

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

#### Voiceflow CLI

```bash
vf test run create --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "testID": "<string>"
}
JSON
```


## Create many runs

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

### Endpoint

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

### Responses

#### 201

Creates one run for each test ID in the request body and returns them all under a shared `bulkID` identifying the batch. Each run comes back in the same shape as a single run, with its own `status`, check tallies, and logs.

Schema:

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

Example:

```json
{
  "runs": [
    {
      "id": "<string>",
      "logs": [
        "<SimulationRunLog>"
      ],
      "status": "idle",
      "testID": "<string>",
      "failReason": "<string>",
      "totalChecks": 0,
      "passedChecks": 0,
      "totalCredits": 0,
      "createdAt": "2026-09-10T00:00:00.000Z",
      "startedAt": "2026-09-10T00:00:00.000Z",
      "finishedAt": "2026-09-10T00:00:00.000Z"
    }
  ],
  "bulkID": "<string>"
}
```

### Request examples

#### cURL

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

#### JavaScript

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

#### Python

```python
import requests

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

#### Voiceflow CLI

```bash
vf test run create-many --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "testIDs": [
    "<string>"
  ]
}
JSON
```


## Cancel runs

Stops test runs that have not finished, including queued runs, which are then no longer scheduled. The response names the runs it stopped, the ones that had already finished, and any IDs it could not find.

### Endpoint

```http
POST /v1/stable/test-run/cancel
```

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

### Responses

#### 200

Returns `canceledRunIDs` for the runs this call stopped, `finishedRuns` with the status of runs that had already finished, and `notFoundRunIDs` for IDs with no run in this environment.

Schema:

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

Example:

```json
{
  "canceledRunIDs": [
    "<string>"
  ],
  "finishedRuns": [
    {
      "id": "<string>",
      "status": "idle"
    }
  ],
  "notFoundRunIDs": [
    "<string>"
  ]
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/test-run/cancel?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "runIDs": [
    "<string>"
  ]
}'
```

#### JavaScript

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

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/test-run/cancel?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "runIDs": [
        "<string>"
      ]
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf test run cancel --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "runIDs": [
    "<string>"
  ]
}
JSON
```


## Wait for runs

Wait until runs finish or the time is up.

### Endpoint

```http
POST /v1/stable/test-run/wait
```

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

### Responses

#### 200

Schema:

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

Example:

```json
{
  "done": true,
  "stoppedBy": "finished",
  "waitedSeconds": 0,
  "runs": [
    {
      "runID": "<string>",
      "testID": "<string>",
      "status": "idle",
      "passedChecks": 0,
      "totalChecks": 0,
      "failReason": "<string>",
      "failedChecks": [
        {
          "checkID": "<string>",
          "type": "<string>",
          "reason": "<string>"
        }
      ],
      "logsIncomplete": true
    }
  ],
  "notFoundRunIDs": [
    "<string>"
  ],
  "note": "<string>"
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/test-run/wait?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "runIDs": [
    "<string>"
  ],
  "timeoutSeconds": 45
}'
```

#### JavaScript

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

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/test-run/wait?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "runIDs": [
        "<string>"
      ],
      "timeoutSeconds": 45
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf test run wait --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "runIDs": [
    "<string>"
  ],
  "timeoutSeconds": 45
}
JSON
```


## Get run

Returns a single test run by ID, with the fields that define it. A test run is one execution of a test, carrying how many of its checks passed.

### Endpoint

```http
GET /v1/stable/test-run/{runID}
```

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

### Authentication

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

`token`:

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

### Path parameters

#### `runID`

Required · string

The ID of the test run 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 run's outcome: its `status`, how many checks it evaluated and how many passed, the credits it consumed, and the trace and tool-call events recorded as the agent worked through the conversation. `passedChecks` and `finishedAt` are null until the run finishes, and `failReason` is null unless it finished in a failed state.

Schema:

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

Example:

```json
{
  "run": {
    "id": "<string>",
    "logs": [
      "<SimulationRunEndLog>"
    ],
    "status": "idle",
    "testID": "<string>",
    "failReason": "<string>",
    "totalChecks": 0,
    "passedChecks": 0,
    "totalCredits": 0,
    "createdAt": "2026-09-10T00:00:00.000Z",
    "startedAt": "2026-09-10T00:00:00.000Z",
    "finishedAt": "2026-09-10T00:00:00.000Z"
  }
}
```

### Request examples

#### cURL

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

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test-run/<runID>?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-run/<runID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf test run get --run-id <runID> --project-id <projectID> --environment-alias <environmentAlias>
```


## Query run logs

Searches the log of one test run, filtering entries by kind, level, debug kind, turn or text, a page at a time. Each page also reports the log's total entry count and token use per model; send `nextOffset` back for the next page.

### Endpoint

```http
POST /v1/stable/test-run/{runID}/logs
```

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

### Authentication

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

`token`:

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

### Path parameters

#### `runID`

Required · string

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

### Responses

#### 200

Returns one page of the log entries that match the filters, with the counts for the whole log, the token use per model, and `nextOffset` for the next page (null on the last page).

Schema:

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

Example:

```json
{
  "total": 0,
  "turnCount": 0,
  "counts": {
    "byKind": {
      "user": 0,
      "agent": 0,
      "debug": 0,
      "check": 0,
      "system": 0
    },
    "byLevel": {
      "fatal": 0,
      "error": 0,
      "warn": 0,
      "info": 0,
      "debug": 0
    },
    "byDebugKind": {
      "llm": 0,
      "tokens": 0,
      "tool": 0,
      "agent": 0,
      "kb": 0,
      "variables": 0,
      "node": 0,
      "other": 0
    }
  },
  "tokens": [
    {
      "model": "<string>",
      "calls": 0,
      "inputTokens": 0,
      "outputTokens": 0,
      "totalTokens": 0,
      "credits": 0
    }
  ],
  "matches": 0,
  "entries": [
    {
      "index": 0,
      "turn": 0,
      "time": "<string>",
      "kind": "user",
      "type": "<string>",
      "level": "fatal",
      "debugKinds": [
        "<StableLogDebugKind>"
      ],
      "source": "<string>",
      "ref": "<StableLogEntryRef>",
      "message": "<string>",
      "fields": {},
      "raw": {}
    }
  ],
  "hasMore": true,
  "nextOffset": 0,
  "truncated": true
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/test-run/<runID>/logs?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "kinds": [
    "user"
  ],
  "levels": [
    "fatal"
  ],
  "debugKinds": [
    "llm"
  ],
  "turns": [
    0
  ],
  "search": "<string>",
  "detail": "summary",
  "limit": 50,
  "offset": 0,
  "order": "asc"
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test-run/<runID>/logs?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kinds": [
      "user"
    ],
    "levels": [
      "fatal"
    ],
    "debugKinds": [
      "llm"
    ],
    "turns": [
      0
    ],
    "search": "<string>",
    "detail": "summary",
    "limit": 50,
    "offset": 0,
    "order": "asc"
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/test-run/<runID>/logs?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "kinds": [
        "user"
      ],
      "levels": [
        "fatal"
      ],
      "debugKinds": [
        "llm"
      ],
      "turns": [
        0
      ],
      "search": "<string>",
      "detail": "summary",
      "limit": 50,
      "offset": 0,
      "order": "asc"
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf test run query-logs --run-id <runID> --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "kinds": [
    "user"
  ],
  "levels": [
    "fatal"
  ],
  "debugKinds": [
    "llm"
  ],
  "turns": [
    0
  ],
  "search": "<string>",
  "detail": "summary",
  "limit": 50,
  "offset": 0,
  "order": "asc"
}
JSON
```


## Schema definitions

### BaseRequest

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "payload": {},
    "diagramID": {
      "type": "string"
    },
    "time": {
      "type": "number"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "type"
  ]
}
```

### SimulationRunActionLog

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "action"
      ],
      "x-enumNames": [
        "ACTION"
      ]
    },
    "payload": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string"
        },
        "payload": {},
        "diagramID": {
          "type": "string"
        },
        "time": {
          "type": "number"
        },
        "metadata": {
          "type": "object",
          "additionalProperties": {}
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": {}
    },
    "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))$"
    },
    "seq": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id",
    "type",
    "payload",
    "createdAt"
  ]
}
```

### SimulationRunEndLog

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "end"
      ],
      "x-enumNames": [
        "END"
      ]
    },
    "payload": {
      "type": "object",
      "properties": {
        "reason": {
          "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))$"
    },
    "seq": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id",
    "type",
    "payload",
    "createdAt"
  ]
}
```

### SimulationRunLog

```json
{
  "oneOf": [
    {
      "$ref": "#/components/schemas/SimulationRunEndLog"
    },
    {
      "$ref": "#/components/schemas/SimulationRunTraceLog"
    },
    {
      "$ref": "#/components/schemas/SimulationRunActionLog"
    }
  ]
}
```

### SimulationRunTraceLog

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "trace"
      ],
      "x-enumNames": [
        "TRACE"
      ]
    },
    "payload": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string"
        },
        "paths": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/TracePath"
          }
        },
        "defaultPath": {
          "type": "number"
        },
        "time": {
          "type": "number"
        },
        "turnID": {
          "type": "string"
        },
        "handleID": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": {}
    },
    "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))$"
    },
    "seq": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id",
    "type",
    "payload",
    "createdAt"
  ]
}
```

### StableLogCounts

```json
{
  "type": "object",
  "properties": {
    "byKind": {
      "type": "object",
      "properties": {
        "user": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "agent": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "debug": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "check": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "system": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "user",
        "agent",
        "debug",
        "check",
        "system"
      ]
    },
    "byLevel": {
      "type": "object",
      "properties": {
        "fatal": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "error": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "warn": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "info": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "debug": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "fatal",
        "error",
        "warn",
        "info",
        "debug"
      ]
    },
    "byDebugKind": {
      "type": "object",
      "properties": {
        "llm": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "tokens": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "tool": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "agent": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "kb": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "variables": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "node": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "other": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "llm",
        "tokens",
        "tool",
        "agent",
        "kb",
        "variables",
        "node",
        "other"
      ]
    }
  },
  "required": [
    "byKind",
    "byLevel",
    "byDebugKind"
  ],
  "description": "How many entries of each kind, level and debug kind the whole log holds, before any filter."
}
```

### StableLogDebugKind

```json
{
  "type": "string",
  "enum": [
    "llm",
    "tokens",
    "tool",
    "agent",
    "kb",
    "variables",
    "node",
    "other"
  ],
  "description": "llm: a model call and its result. tokens: token and credit use of one model call. tool: a tool call or its result (functions, API tools, integrations, MCP tools). agent: an agent or playbook starting, ending or handing over. kb: a knowledge base search. variables: variable changes. node: a workflow step. other: anything else.",
  "x-enumNames": [
    "LLM",
    "TOKENS",
    "TOOL",
    "AGENT",
    "KB",
    "VARIABLES",
    "NODE",
    "OTHER"
  ]
}
```

### StableLogDetail

```json
{
  "type": "string",
  "enum": [
    "summary",
    "full"
  ],
  "description": "summary: each entry with a one-line message and its small recorded values. full: also the entry as recorded, with strings cut at 4,000 characters and lists at 50 items.",
  "x-enumNames": [
    "SUMMARY",
    "FULL"
  ]
}
```

### StableLogEntry

```json
{
  "type": "object",
  "properties": {
    "index": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Where the entry sits in the whole log, oldest first, from 0."
    },
    "turn": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "The turn of the entry. Each user input, a launch included, starts the next turn. Anything logged before the first input, such as a test run's greeting, is turn 0."
    },
    "time": {
      "type": "string",
      "description": "When the entry was logged, as an ISO 8601 timestamp."
    },
    "kind": {
      "$ref": "#/components/schemas/StableLogEntryKind"
    },
    "type": {
      "type": "string",
      "description": "The trace or request type as recorded, such as text, debug, launch or end."
    },
    "level": {
      "$ref": "#/components/schemas/StableLogLevel"
    },
    "debugKinds": {
      "description": "Debug entries only. An entry can be of several kinds.",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableLogDebugKind"
      }
    },
    "source": {
      "description": "Debug entries only: the part of the runtime that logged it, such as Agent.",
      "type": "string"
    },
    "ref": {
      "allOf": [
        {
          "$ref": "#/components/schemas/StableLogEntryRef"
        }
      ]
    },
    "message": {
      "type": "string",
      "description": "What happened, in one line of at most 500 characters."
    },
    "fields": {
      "description": "Up to 24 small values recorded with the entry, such as model, tokens, latency, status or a variable before and after. Nested keys are joined with dots, and strings are cut at 200 characters.",
      "type": "object",
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "string",
            "nullable": true,
            "enum": [
              null
            ]
          }
        ]
      }
    },
    "raw": {
      "description": "With detail full only: the entry as recorded, with strings cut at 4,000 characters and lists at 50 items.",
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "index",
    "turn",
    "time",
    "kind",
    "type",
    "level",
    "message"
  ]
}
```

### StableLogEntryKind

```json
{
  "type": "string",
  "enum": [
    "user",
    "agent",
    "debug",
    "check",
    "system"
  ],
  "description": "user: what the user sent. agent: what the agent said or showed. debug: a runtime debug log. check: a test check result, test runs only. system: any other event, such as a block, a workflow or the end.",
  "x-enumNames": [
    "USER",
    "AGENT",
    "DEBUG",
    "CHECK",
    "SYSTEM"
  ]
}
```

### StableLogEntryRef

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "What the entry is about: agent, function, api-tool, integration-tool, prompt or node."
    },
    "id": {
      "description": "The ID of that agent, tool, prompt or workflow step.",
      "type": "string"
    },
    "name": {
      "description": "Its name; for a workflow step, the name of its workflow.",
      "type": "string"
    }
  },
  "required": [
    "type"
  ]
}
```

### StableLogLevel

```json
{
  "type": "string",
  "enum": [
    "fatal",
    "error",
    "warn",
    "info",
    "debug"
  ],
  "description": "A debug log carries its own level. A failed check is error. Every other entry is info.",
  "x-enumNames": [
    "FATAL",
    "ERROR",
    "WARN",
    "INFO",
    "DEBUG"
  ]
}
```

### StableLogOrder

```json
{
  "type": "string",
  "enum": [
    "asc",
    "desc"
  ],
  "description": "asc: oldest first. desc: newest first.",
  "x-enumNames": [
    "ASC",
    "DESC"
  ]
}
```

### StableLogQueryRequest

```json
{
  "type": "object",
  "properties": {
    "kinds": {
      "description": "Keep only entries of these kinds. Omit to keep every kind.",
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableLogEntryKind"
      }
    },
    "levels": {
      "description": "Keep only entries at these levels, for example [\"fatal\", \"error\", \"warn\"] for what went wrong.",
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableLogLevel"
      }
    },
    "debugKinds": {
      "description": "Keep only debug entries of these kinds. Setting it leaves out every entry that is not a debug log.",
      "minItems": 1,
      "maxItems": 8,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableLogDebugKind"
      }
    },
    "turns": {
      "description": "Keep only entries of these turns. Turn 0 holds anything logged before the first input.",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991
      }
    },
    "search": {
      "description": "Keep only entries whose message or recorded data contains this text, ignoring case. It is plain text, not a regular expression. Separate alternatives with |, as in \"timeout|denied\", to keep entries that contain any of them.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "detail": {
      "default": "summary",
      "allOf": [
        {
          "$ref": "#/components/schemas/StableLogDetail"
        }
      ]
    },
    "limit": {
      "default": 50,
      "description": "The most entries to return in one page.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "default": 0,
      "description": "How many matching entries to skip, for paging.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "order": {
      "default": "asc",
      "allOf": [
        {
          "$ref": "#/components/schemas/StableLogOrder"
        }
      ]
    }
  },
  "additionalProperties": false
}
```

### StableLogQueryResponse

```json
{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Entries in the whole log."
    },
    "turnCount": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "The last turn the log reaches."
    },
    "counts": {
      "$ref": "#/components/schemas/StableLogCounts"
    },
    "tokens": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableLogTokenUsage"
      },
      "description": "Token use per model over the whole log, largest first."
    },
    "matches": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Entries that pass every filter."
    },
    "entries": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableLogEntry"
      },
      "description": "This page of the matching entries."
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextOffset": {
      "nullable": true,
      "description": "The offset of the next page, or null when this page reaches the last match.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "truncated": {
      "type": "boolean",
      "description": "True when the page stopped before limit to stay under about 30,000 tokens. Continue from nextOffset."
    }
  },
  "required": [
    "total",
    "turnCount",
    "counts",
    "tokens",
    "matches",
    "entries",
    "hasMore",
    "nextOffset",
    "truncated"
  ]
}
```

### StableLogTokenUsage

```json
{
  "type": "object",
  "properties": {
    "model": {
      "type": "string"
    },
    "calls": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Model calls that logged their token use."
    },
    "inputTokens": {
      "type": "number"
    },
    "outputTokens": {
      "type": "number"
    },
    "totalTokens": {
      "type": "number"
    },
    "credits": {
      "type": "number",
      "description": "Voiceflow credits the calls used, 0 when the log does not record them."
    }
  },
  "required": [
    "model",
    "calls",
    "inputTokens",
    "outputTokens",
    "totalTokens",
    "credits"
  ]
}
```

### StableTestRun

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "logs": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/SimulationRunLog"
      },
      "description": "The trace, tool-call, and end events recorded as the run executed."
    },
    "status": {
      "type": "string",
      "enum": [
        "idle",
        "pending",
        "running",
        "failed",
        "passed",
        "canceled"
      ],
      "description": "Where the run is in its lifecycle, from queued through to a finished outcome.",
      "x-enumNames": [
        "IDLE",
        "PENDING",
        "RUNNING",
        "FAILED",
        "PASSED",
        "CANCELED"
      ]
    },
    "testID": {
      "type": "string",
      "description": "The ID of the test this run belongs to."
    },
    "failReason": {
      "nullable": true,
      "description": "Why the run failed. Null unless the run finished in a failed state.",
      "type": "string"
    },
    "totalChecks": {
      "type": "number",
      "description": "The number of checks across the test's turns that this run evaluated."
    },
    "passedChecks": {
      "nullable": true,
      "description": "How many of those checks passed. Null until the run reaches a finished state.",
      "type": "number"
    },
    "totalCredits": {
      "type": "number",
      "description": "The LLM credits consumed by this run."
    },
    "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))$"
    },
    "startedAt": {
      "nullable": true,
      "description": "When execution actually began. Null while still queued.",
      "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))$"
    },
    "finishedAt": {
      "nullable": true,
      "description": "When the run reached a finished state. Null while in progress.",
      "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",
    "logs",
    "status",
    "testID",
    "failReason",
    "totalChecks",
    "passedChecks",
    "totalCredits",
    "createdAt",
    "startedAt",
    "finishedAt"
  ]
}
```

### StableTestRunCancelFinishedRun

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "idle",
        "pending",
        "running",
        "failed",
        "passed",
        "canceled"
      ],
      "description": "The status the run kept.",
      "x-enumNames": [
        "IDLE",
        "PENDING",
        "RUNNING",
        "FAILED",
        "PASSED",
        "CANCELED"
      ]
    }
  },
  "required": [
    "id",
    "status"
  ]
}
```

### StableTestRunCancelRequest

```json
{
  "type": "object",
  "properties": {
    "runIDs": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The IDs of the runs to cancel."
    }
  },
  "required": [
    "runIDs"
  ],
  "additionalProperties": false
}
```

### StableTestRunCancelResponse

```json
{
  "type": "object",
  "properties": {
    "canceledRunIDs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The runs this call canceled. A run that had not started yet will never start."
    },
    "finishedRuns": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableTestRunCancelFinishedRun"
      },
      "description": "Runs that had already finished, so the call left them as they were."
    },
    "notFoundRunIDs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "IDs with no run in this environment."
    }
  },
  "required": [
    "canceledRunIDs",
    "finishedRuns",
    "notFoundRunIDs"
  ]
}
```

### StableTestRunCreateManyRequest

```json
{
  "type": "object",
  "properties": {
    "testIDs": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The IDs of the tests to run, one run created per test."
    }
  },
  "required": [
    "testIDs"
  ],
  "additionalProperties": false
}
```

### StableTestRunCreateManyResponse

```json
{
  "type": "object",
  "properties": {
    "runs": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableTestRun"
      }
    },
    "bulkID": {
      "type": "string",
      "description": "Groups the runs created by this call so they can be searched or tracked together."
    }
  },
  "required": [
    "runs",
    "bulkID"
  ]
}
```

### StableTestRunCreateRequest

```json
{
  "type": "object",
  "properties": {
    "testID": {
      "type": "string",
      "description": "The ID of the test to run."
    }
  },
  "required": [
    "testID"
  ],
  "additionalProperties": false
}
```

### StableTestRunListResponse

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

### StableTestRunResponse

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

### StableTestRunSearchRequest

```json
{
  "type": "object",
  "properties": {
    "take": {
      "default": 20,
      "description": "The maximum number of results to return, used for pagination.",
      "type": "number",
      "minimum": 1,
      "maximum": 100
    },
    "skip": {
      "default": 0,
      "description": "The number of results to skip, used for pagination.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "testID": {
      "description": "Restrict results to runs of this test. Omit to search across all tests.",
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

### StableTestRunWaitRequest

```json
{
  "type": "object",
  "properties": {
    "runIDs": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "The runs to wait for: the IDs create_run or create_many_runs returned (each run's `id`, not its `testID`)."
    },
    "timeoutSeconds": {
      "default": 45,
      "description": "How long to wait at most, in seconds: 45 by default, 120 at most.",
      "type": "integer",
      "minimum": 5,
      "maximum": 120
    }
  },
  "required": [
    "runIDs"
  ],
  "additionalProperties": false
}
```

### StableTestRunWaitResponse

```json
{
  "type": "object",
  "properties": {
    "done": {
      "type": "boolean",
      "description": "Every run found has passed, failed or been canceled."
    },
    "stoppedBy": {
      "type": "string",
      "enum": [
        "finished",
        "timeout",
        "abort"
      ],
      "x-enumNames": [
        "FINISHED",
        "TIMEOUT",
        "ABORT"
      ]
    },
    "waitedSeconds": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "runs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "runID": {
            "type": "string"
          },
          "testID": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "idle",
              "pending",
              "running",
              "failed",
              "passed",
              "canceled"
            ],
            "x-enumNames": [
              "IDLE",
              "PENDING",
              "RUNNING",
              "FAILED",
              "PASSED",
              "CANCELED"
            ]
          },
          "passedChecks": {
            "nullable": true,
            "type": "number"
          },
          "totalChecks": {
            "type": "number"
          },
          "failReason": {
            "nullable": true,
            "type": "string"
          },
          "failedChecks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "checkID": {
                  "nullable": true,
                  "type": "string"
                },
                "type": {
                  "nullable": true,
                  "type": "string"
                },
                "reason": {
                  "type": "string"
                }
              },
              "required": [
                "checkID",
                "type",
                "reason"
              ]
            }
          },
          "logsIncomplete": {
            "description": "The run finished before all its logs were stored.",
            "type": "boolean"
          }
        },
        "required": [
          "runID",
          "testID",
          "status",
          "passedChecks",
          "totalChecks",
          "failReason"
        ]
      }
    },
    "notFoundRunIDs": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "done",
    "stoppedBy",
    "waitedSeconds",
    "runs"
  ]
}
```

### TracePath

```json
{
  "type": "object",
  "properties": {
    "label": {
      "type": "string"
    },
    "event": {
      "allOf": [
        {
          "$ref": "#/components/schemas/BaseRequest"
        }
      ]
    }
  }
}
```
