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

# Transcripts

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

API version: Selected per operation

## Search transcripts

Finds recorded conversations matching a filter. Unlike the list calls elsewhere in this API, the body takes `take` and `skip`, so results arrive a page at a time.

### Endpoint

```http
POST /v1/stable/transcript/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."
}
```

### Request body

Required

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

### Responses

#### 200

Returns the transcripts matching the search, each with its session and user IDs, timestamps, recording URL, and any properties and evaluation results attached to it. The conversation logs are not included.

Schema:

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

Example:

```json
{
  "transcripts": [
    {
      "id": "<string>",
      "userID": "<string>",
      "endedAt": "2026-09-10T00:00:00.000Z",
      "projectID": "<string>",
      "sessionID": "<string>",
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "expiresAt": "2026-09-10T00:00:00.000Z",
      "properties": [
        "<StableTranscriptPropertyWithValue>"
      ],
      "evaluations": [
        "<StableEvaluationWithResult>"
      ],
      "recordingURL": "<string>",
      "version": "draft",
      "environmentAlias": "<string>"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/transcript/search?projectID=<projectID>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "take": 20,
  "skip": 0,
  "endDate": "2026-09-10T00:00:00.000Z",
  "version": "draft",
  "filters": [
    {
      "id": "<string>",
      "op": "gt",
      "value": 0
    }
  ],
  "sessionID": "<string>",
  "startDate": "2026-09-10T00:00:00.000Z",
  "environmentAlias": "<string>",
  "releaseName": "<string>"
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/transcript/search?projectID=<projectID>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "take": 20,
    "skip": 0,
    "endDate": "2026-09-10T00:00:00.000Z",
    "version": "draft",
    "filters": [
      {
        "id": "<string>",
        "op": "gt",
        "value": 0
      }
    ],
    "sessionID": "<string>",
    "startDate": "2026-09-10T00:00:00.000Z",
    "environmentAlias": "<string>",
    "releaseName": "<string>"
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/transcript/search?projectID=<projectID>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "take": 20,
      "skip": 0,
      "endDate": "2026-09-10T00:00:00.000Z",
      "version": "draft",
      "filters": [
        {
          "id": "<string>",
          "op": "gt",
          "value": 0
        }
      ],
      "sessionID": "<string>",
      "startDate": "2026-09-10T00:00:00.000Z",
      "environmentAlias": "<string>",
      "releaseName": "<string>"
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf transcript search --project-id <projectID> <<'JSON'
{
  "take": 20,
  "skip": 0,
  "endDate": "2026-09-10T00:00:00.000Z",
  "version": "draft",
  "filters": [
    {
      "id": "<string>",
      "op": "gt",
      "value": 0
    }
  ],
  "sessionID": "<string>",
  "startDate": "2026-09-10T00:00:00.000Z",
  "environmentAlias": "<string>",
  "releaseName": "<string>"
}
JSON
```


## Grep transcripts

Find a pattern in the dialogue of many transcripts.

### Endpoint

```http
POST /v1/stable/transcript/grep
```

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

### Request body

Required

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

### Responses

#### 200

Schema:

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

Example:

```json
{
  "pattern": "<string>",
  "scanned": 0,
  "matched": 0,
  "capped": true,
  "errored": 0,
  "skipped": 0,
  "note": "<string>",
  "literalText": true,
  "hits": [
    {
      "transcriptID": "<string>",
      "matches": 0,
      "snippets": [
        "<string>"
      ]
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/transcript/grep?projectID=<projectID>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "pattern": "<string>",
  "transcriptIDs": [
    "<string>"
  ],
  "startDate": "<string>",
  "endDate": "<string>",
  "environmentAlias": "<string>",
  "limit": 25
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/transcript/grep?projectID=<projectID>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "pattern": "<string>",
    "transcriptIDs": [
      "<string>"
    ],
    "startDate": "<string>",
    "endDate": "<string>",
    "environmentAlias": "<string>",
    "limit": 25
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/transcript/grep?projectID=<projectID>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "pattern": "<string>",
      "transcriptIDs": [
        "<string>"
      ],
      "startDate": "<string>",
      "endDate": "<string>",
      "environmentAlias": "<string>",
      "limit": 25
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf transcript grep --project-id <projectID> <<'JSON'
{
  "pattern": "<string>",
  "transcriptIDs": [
    "<string>"
  ],
  "startDate": "<string>",
  "endDate": "<string>",
  "environmentAlias": "<string>",
  "limit": 25
}
JSON
```


## Get transcript

Returns one recorded conversation, including the turns exchanged and the traces behind them. Set `filterConversation` to keep only `text`, `speak`, and `live-agent-handoff` traces, plus any types listed in `customTraceTypes`.

### Endpoint

```http
GET /v1/stable/transcript/{transcriptID}
```

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

### Authentication

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

`token`:

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

### Path parameters

#### `transcriptID`

Required · string

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

#### `filterConversation`

Optional · boolean

When `true`, only `text`, `speak`, and `live-agent-handoff` traces are returned. Omit it or set `false` to return the full log.

```json
{
  "description": "When enabled, only `text`, `speak` and `live-agent-handoff` traces will be returned.",
  "type": "boolean"
}
```

#### `customTraceTypes`

Optional · object

Extra trace types to keep when `filterConversation` is `true`. Ignored when the filter is off. Accepts one type or an array.

```json
{
  "description": "Additional trace types to return when `filterConversation` is enabled.",
  "anyOf": [
    {
      "type": "string"
    },
    {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  ]
}
```

### Responses

#### 200

Returns a single transcript along with its logs, which the search operation leaves out, plus its properties, evaluation results, and recording URL.

Schema:

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

Example:

```json
{
  "transcript": {
    "id": "<string>",
    "userID": "<string>",
    "endedAt": "2026-09-10T00:00:00.000Z",
    "projectID": "<string>",
    "sessionID": "<string>",
    "createdAt": "2026-09-10T00:00:00.000Z",
    "updatedAt": "2026-09-10T00:00:00.000Z",
    "expiresAt": "2026-09-10T00:00:00.000Z",
    "properties": [
      {
        "id": "<string>",
        "name": "<string>",
        "default": true,
        "type": "boolean",
        "createdAt": "2026-09-10T00:00:00.000Z",
        "updatedAt": "2026-09-10T00:00:00.000Z",
        "value": "<string>",
        "metadata": {}
      }
    ],
    "evaluations": [
      {
        "id": "<string>",
        "name": "<string>",
        "default": true,
        "description": "<string>",
        "cost": 0,
        "value": true,
        "reason": "<string>",
        "createdAt": "2026-09-10T00:00:00.000Z",
        "updatedAt": "2026-09-10T00:00:00.000Z"
      }
    ],
    "recordingURL": "<string>",
    "version": "draft",
    "environmentAlias": "<string>",
    "logs": [
      {
        "type": "trace",
        "data": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>"
      }
    ]
  }
}
```

### Request examples

#### cURL

```bash
curl --request GET \
  --url 'https://realtime-api.voiceflow.com/v1/stable/transcript/<transcriptID>?projectID=<projectID>&filterConversation=<filterConversation>&customTraceTypes=<customTraceTypes>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

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

#### Voiceflow CLI

```bash
vf transcript get --transcript-id <transcriptID> --project-id <projectID> --filter-conversation <filterConversation> --custom-trace-types <customTraceTypes>
```


## List transcript files

Returns the files attached to one transcript that Voiceflow stores, each with a presigned download URL; files referenced only by an external URL are left out. The call is unpaginated: it takes no paging parameters, so one request yields the whole set.

### Endpoint

```http
GET /v1/stable/transcript/{transcriptID}/files
```

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

### Authentication

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

`token`:

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

### Path parameters

#### `transcriptID`

Required · string

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

### Responses

#### 200

Returns the transcript's stored files, each with a stable ID, MIME type, original filename and size when recorded, a presigned GET URL, and the timestamp after which that URL stops working.

Schema:

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

Example:

```json
{
  "files": [
    {
      "id": "<string>",
      "filename": "<string>",
      "mimeType": "<string>",
      "size": 0,
      "url": "<string>",
      "expiresAt": "2026-09-10T00:00:00.000Z"
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request GET \
  --url 'https://realtime-api.voiceflow.com/v1/stable/transcript/<transcriptID>/files?projectID=<projectID>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

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

#### Voiceflow CLI

```bash
vf transcript files --transcript-id <transcriptID> --project-id <projectID>
```


## Query transcript logs

Searches one recorded conversation's log by entry kind, level, debug kind, turn or text, and returns the matches a page at a time. Use it to find errors or tool calls without reading the whole transcript.

### Endpoint

```http
POST /v1/stable/transcript/{transcriptID}/logs
```

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

### Authentication

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

`token`:

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

### Path parameters

#### `transcriptID`

Required · string

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

### Request body

Required

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

### Responses

#### 200

Returns the matching entries for this page, with the number of matches, the whole log's entry counts and token use per model, and the offset to send for the next 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/transcript/<transcriptID>/logs?projectID=<projectID>' \
  --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/transcript/<transcriptID>/logs?projectID=<projectID>', {
  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/transcript/<transcriptID>/logs?projectID=<projectID>',
    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 transcript query-logs --transcript-id <transcriptID> --project-id <projectID> <<'JSON'
{
  "kinds": [
    "user"
  ],
  "levels": [
    "fatal"
  ],
  "debugKinds": [
    "llm"
  ],
  "turns": [
    0
  ],
  "search": "<string>",
  "detail": "summary",
  "limit": 50,
  "offset": 0,
  "order": "asc"
}
JSON
```


## Schema definitions

### StableEvaluationWithResult

```json
{
  "allOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "default": {
          "type": "boolean",
          "description": "Whether this is a built-in default evaluation."
        },
        "description": {
          "nullable": true,
          "description": "A human-readable description of what this evaluation measures.",
          "type": "string"
        },
        "cost": {
          "type": "number",
          "description": "The cost incurred to run this evaluation against the transcript."
        },
        "value": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "number"
            },
            {
              "type": "string"
            }
          ],
          "description": "The result produced by the evaluation, typed according to the evaluation `type`."
        },
        "reason": {
          "type": "string",
          "description": "The explanation of why the evaluation produced this result."
        },
        "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",
        "name",
        "default",
        "description",
        "cost",
        "value",
        "reason",
        "createdAt",
        "updatedAt"
      ]
    },
    {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "boolean"
              ],
              "description": "Discriminator indicating the evaluation produces a boolean result.",
              "x-enumNames": [
                "BOOLEAN"
              ]
            }
          },
          "required": [
            "type"
          ]
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "number"
              ],
              "description": "Discriminator indicating the evaluation produces a numeric result.",
              "x-enumNames": [
                "NUMBER"
              ]
            },
            "minimumValue": {
              "type": "number",
              "description": "The lowest value the evaluation result can take."
            },
            "maximumValue": {
              "type": "number",
              "description": "The highest value the evaluation result can take."
            }
          },
          "required": [
            "type",
            "minimumValue",
            "maximumValue"
          ]
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "string"
              ],
              "description": "Discriminator indicating the evaluation produces a free-form text result.",
              "x-enumNames": [
                "STRING"
              ]
            }
          },
          "required": [
            "type"
          ]
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "option"
              ],
              "description": "Discriminator indicating the evaluation picks a result from a predefined set of options.",
              "x-enumNames": [
                "OPTION"
              ]
            },
            "options": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "value": {
                    "type": "string",
                    "description": "The value assigned to the evaluation result when this option is selected."
                  },
                  "prompt": {
                    "type": "string",
                    "description": "The criteria describing when the evaluator should select this option."
                  },
                  "included": {
                    "type": "boolean",
                    "description": "Whether this option is available for the evaluator to select."
                  },
                  "color": {
                    "type": "string",
                    "description": "The color used to display this option in the Voiceflow UI."
                  }
                },
                "required": [
                  "value",
                  "prompt",
                  "included",
                  "color"
                ]
              }
            }
          },
          "required": [
            "type",
            "options"
          ]
        }
      ]
    }
  ]
}
```

### 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"
  ]
}
```

### StableTranscript

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "userID": {
      "type": "string",
      "description": "The ID of the end user who had the conversation."
    },
    "endedAt": {
      "nullable": true,
      "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))$"
    },
    "projectID": {
      "type": "string",
      "description": "The ID of the project the conversation happened in."
    },
    "sessionID": {
      "type": "string",
      "description": "The ID of the conversation session this transcript was recorded from."
    },
    "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))$"
    },
    "expiresAt": {
      "nullable": true,
      "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))$"
    },
    "properties": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableTranscriptPropertyWithValue"
      }
    },
    "evaluations": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableEvaluationWithResult"
      }
    },
    "recordingURL": {
      "nullable": true,
      "description": "The URL of the call recording for voice conversations.",
      "type": "string"
    },
    "version": {
      "nullable": true,
      "description": "Whether the conversation happened on the draft or published version of the environment. `null` for legacy conversations recorded before environments existed, or when the version is no longer tracked by the environment.",
      "type": "string",
      "enum": [
        "draft",
        "published"
      ],
      "x-enumNames": [
        "DRAFT",
        "PUBLISHED"
      ]
    },
    "environmentAlias": {
      "nullable": true,
      "description": "The alias of the environment the conversation happened in. `null` for legacy conversations recorded before environments existed, as well as deleted environments.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "userID",
    "endedAt",
    "projectID",
    "sessionID",
    "createdAt",
    "updatedAt",
    "expiresAt",
    "properties",
    "evaluations",
    "recordingURL",
    "version",
    "environmentAlias"
  ]
}
```

### StableTranscriptFile

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A stable, opaque identifier for the file. Unlike `url`, it does not change between requests."
    },
    "filename": {
      "description": "The original name of the uploaded file, when recorded.",
      "type": "string"
    },
    "mimeType": {
      "type": "string",
      "description": "The MIME type of the file."
    },
    "size": {
      "description": "The size of the file in bytes, when recorded.",
      "type": "number"
    },
    "url": {
      "type": "string",
      "description": "A presigned GET URL for downloading the file."
    },
    "expiresAt": {
      "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))$",
      "description": "ISO 8601 timestamp after which the presigned `url` is no longer valid."
    }
  },
  "required": [
    "id",
    "mimeType",
    "url",
    "expiresAt"
  ]
}
```

### StableTranscriptFilesResponse

```json
{
  "type": "object",
  "properties": {
    "files": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableTranscriptFile"
      },
      "description": "The files attached to the transcript that are stored on Voiceflow."
    }
  },
  "required": [
    "files"
  ]
}
```

### StableTranscriptGrepHit

```json
{
  "type": "object",
  "properties": {
    "transcriptID": {
      "type": "string"
    },
    "matches": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many dialogue lines matched."
    },
    "snippets": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Up to 5 matching lines, each cut to 240 characters."
    }
  },
  "required": [
    "transcriptID",
    "matches",
    "snippets"
  ]
}
```

### StableTranscriptGrepRequest

```json
{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string",
      "minLength": 1,
      "description": "Regex (case-insensitive) or plain text to find in the dialogue. A pattern may hold one open quantifier (*, +, ?, {n,} or {n,m}), no backreference and no alternation inside a group. Use exact counts such as \\d{3}, or put the alternation at the top level: refund|return. Any other pattern runs as plain text, and the result says so."
    },
    "transcriptIDs": {
      "description": "Transcripts to scan. Leave it out to scan the newest transcripts in the date range.",
      "minItems": 1,
      "maxItems": 60,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "startDate": {
      "description": "Lower bound when no transcriptIDs are given: a day or a timestamp.",
      "anyOf": [
        {
          "type": "string",
          "format": "date",
          "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])))$"
        },
        {
          "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))$"
        }
      ]
    },
    "endDate": {
      "description": "Upper bound when no transcriptIDs are given: a day or a timestamp.",
      "anyOf": [
        {
          "type": "string",
          "format": "date",
          "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])))$"
        },
        {
          "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))$"
        }
      ]
    },
    "environmentAlias": {
      "description": "Only transcripts from this environment, when no transcriptIDs are given.",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "How many transcripts to scan at most, 1 to 60.",
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    }
  },
  "required": [
    "pattern"
  ],
  "additionalProperties": false
}
```

### StableTranscriptGrepResponse

```json
{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string"
    },
    "scanned": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Transcripts scanned."
    },
    "matched": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Transcripts with at least one match."
    },
    "capped": {
      "description": "More transcripts were in the range, or more unique transcriptIDs were given, than were scanned; `note` says what to do.",
      "type": "boolean"
    },
    "errored": {
      "description": "Transcripts whose log could not be read.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "skipped": {
      "description": "Given transcriptIDs that do not belong to this project.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "note": {
      "type": "string"
    },
    "literalText": {
      "description": "The pattern ran as plain text; `note` says why.",
      "type": "boolean",
      "enum": [
        true
      ],
      "x-enumNames": [
        "TRUE"
      ]
    },
    "hits": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableTranscriptGrepHit"
      }
    }
  },
  "required": [
    "pattern",
    "scanned",
    "matched",
    "hits"
  ]
}
```

### StableTranscriptListResponse

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

### StableTranscriptPropertyWithValue

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "default": {
      "type": "boolean",
      "description": "Whether this is a built-in property, which cannot be updated, deleted or have its value set."
    },
    "type": {
      "type": "string",
      "enum": [
        "boolean",
        "number",
        "string"
      ],
      "description": "The type of value the property holds.",
      "x-enumNames": [
        "BOOLEAN",
        "NUMBER",
        "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))$"
    },
    "value": {
      "type": "string",
      "description": "The value of the property recorded for this transcript."
    },
    "metadata": {
      "nullable": true,
      "description": "Additional structured data recorded alongside the value, such as the credits used per model for the built-in credits property. `null` when none was recorded.",
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "id",
    "name",
    "default",
    "type",
    "createdAt",
    "updatedAt",
    "value",
    "metadata"
  ]
}
```

### StableTranscriptSearchRequest

```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
    },
    "endDate": {
      "description": "When provided, only transcripts created at or before this ISO 8601 timestamp are returned.",
      "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))$"
    },
    "version": {
      "description": "When provided, only transcripts from the draft or published version of the environment are returned. `published` covers the current release and every past release. Applies within a single environment; the main environment is used when `environmentAlias` is omitted.",
      "type": "string",
      "enum": [
        "draft",
        "published"
      ],
      "x-enumNames": [
        "DRAFT",
        "PUBLISHED"
      ]
    },
    "filters": {
      "allOf": [
        {
          "$ref": "#/components/schemas/TranscriptFilterArray"
        }
      ]
    },
    "sessionID": {
      "description": "When provided, only transcripts from this conversation session are returned.",
      "type": "string"
    },
    "startDate": {
      "description": "When provided, only transcripts created at or after this ISO 8601 timestamp are returned.",
      "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))$"
    },
    "environmentAlias": {
      "description": "When provided, only transcripts from the environment with this alias are returned.",
      "type": "string"
    },
    "releaseName": {
      "description": "When provided, only transcripts from the release with this exact name (e.g. `V1.02`) are returned, as listed in the `releases` of the environment. When several releases share the name, transcripts from all of them are returned. Applies within a single environment; the main environment is used when `environmentAlias` is omitted. Cannot be combined with `version: \"draft\"`.",
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}
```

### StableTranscriptWithLogsResponse

```json
{
  "type": "object",
  "properties": {
    "transcript": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "userID": {
          "type": "string",
          "description": "The ID of the end user who had the conversation."
        },
        "endedAt": {
          "nullable": true,
          "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))$"
        },
        "projectID": {
          "type": "string",
          "description": "The ID of the project the conversation happened in."
        },
        "sessionID": {
          "type": "string",
          "description": "The ID of the conversation session this transcript was recorded from."
        },
        "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))$"
        },
        "expiresAt": {
          "nullable": true,
          "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))$"
        },
        "properties": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/StableTranscriptPropertyWithValue"
          }
        },
        "evaluations": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/StableEvaluationWithResult"
          }
        },
        "recordingURL": {
          "nullable": true,
          "description": "The URL of the call recording for voice conversations.",
          "type": "string"
        },
        "version": {
          "nullable": true,
          "description": "Whether the conversation happened on the draft or published version of the environment. `null` for legacy conversations recorded before environments existed, or when the version is no longer tracked by the environment.",
          "type": "string",
          "enum": [
            "draft",
            "published"
          ],
          "x-enumNames": [
            "DRAFT",
            "PUBLISHED"
          ]
        },
        "environmentAlias": {
          "nullable": true,
          "description": "The alias of the environment the conversation happened in. `null` for legacy conversations recorded before environments existed, as well as deleted environments.",
          "type": "string"
        },
        "logs": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "trace",
                  "action",
                  "end"
                ],
                "x-enumNames": [
                  "TRACE",
                  "ACTION",
                  "END"
                ]
              },
              "data": {
                "anyOf": [
                  {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      }
                    ]
                  },
                  {
                    "type": "array",
                    "items": {}
                  },
                  {
                    "type": "object",
                    "additionalProperties": {}
                  }
                ]
              },
              "createdAt": {
                "type": "string",
                "format": "date",
                "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])))$"
              },
              "updatedAt": {
                "type": "string",
                "format": "date",
                "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])))$"
              }
            },
            "required": [
              "type",
              "data",
              "createdAt",
              "updatedAt"
            ]
          }
        }
      },
      "required": [
        "id",
        "userID",
        "endedAt",
        "projectID",
        "sessionID",
        "createdAt",
        "updatedAt",
        "expiresAt",
        "properties",
        "evaluations",
        "recordingURL",
        "version",
        "environmentAlias",
        "logs"
      ]
    }
  },
  "required": [
    "transcript"
  ]
}
```

### TranscriptFilter

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "op": {
          "type": "string",
          "enum": [
            "gt",
            "gte",
            "lt",
            "lte"
          ],
          "x-enumNames": [
            "GREATER_THAN",
            "GREATER_THAN_OR_EQUAL",
            "LESS_THAN",
            "LESS_THAN_OR_EQUAL"
          ]
        },
        "value": {
          "type": "number"
        }
      },
      "required": [
        "id",
        "op",
        "value"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "op": {
          "type": "string",
          "enum": [
            "eq",
            "neq"
          ],
          "x-enumNames": [
            "EQUALS",
            "NOT_EQUALS"
          ]
        },
        "value": {
          "anyOf": [
            {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "number"
                }
              ]
            },
            {
              "type": "boolean"
            }
          ]
        }
      },
      "required": [
        "id",
        "op",
        "value"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "op": {
          "type": "string",
          "enum": [
            "between"
          ],
          "x-enumNames": [
            "BETWEEN"
          ]
        },
        "value": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "number"
              }
            ]
          },
          "minItems": 2,
          "maxItems": 2
        }
      },
      "required": [
        "id",
        "op",
        "value"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "op": {
          "type": "string",
          "enum": [
            "in",
            "nin"
          ],
          "x-enumNames": [
            "IN",
            "NOT_IN"
          ]
        },
        "value": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              }
            ]
          }
        }
      },
      "required": [
        "id",
        "op",
        "value"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "op": {
          "type": "string",
          "enum": [
            "contains"
          ],
          "x-enumNames": [
            "CONTAINS"
          ]
        },
        "value": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "op",
        "value"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "op": {
          "type": "string",
          "enum": [
            "exists",
            "not_exists"
          ],
          "x-enumNames": [
            "EXISTS",
            "NOT_EXISTS"
          ]
        }
      },
      "required": [
        "id",
        "op"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "op": {
          "type": "string",
          "enum": [
            "json_contains"
          ],
          "x-enumNames": [
            "JSONB_ARRAY_CONTAINS"
          ]
        },
        "value": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": {}
          }
        }
      },
      "required": [
        "id",
        "op",
        "value"
      ]
    }
  ]
}
```

### TranscriptFilterArray

```json
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/TranscriptFilter"
  }
}
```
