{ "turns": [ { "id": "<string>", "testID": "<string>", "createdAt": "2026-09-10T00:00:00.000Z", "updatedAt": "2026-09-10T00:00:00.000Z", "type": "user", "payload": { "response": "<string>", "variableStates": "<string>" } } ] }

Authorizations

Authorization

string

header

required

Voiceflow bearer token

Query Parameters

projectID

string

required

The ID of the project to operate on.

environmentAlias

string

required

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

testID

string

required

The ID of the test whose turns to list.

Response

200 - application/json

Returns every turn belonging to the test named in testID. A turn is a scripted user message, an agent turn whose checks assert on what the agent did, or a simulation where an LLM plays the user across a stretch of the conversation.

turns

object[]

required

Show child attributes

Option 1

Show child attributes

string

required

testID

string

required

The ID of the test this turn belongs to.

createdAt

string

required

updatedAt

string

required

type

enum<string>

required

Identifies a turn that sends a scripted user message.

Available options: user

payload

object

required

Show child attributes

response

string

required

variableStates

object

required

Show child attributes

Option 1

string

Option 2

Show child attributes

string

required

variableID

string

required

value

string

required

Option 2

Show child attributes

string

required

testID

string

required

The ID of the test this turn belongs to.

createdAt

string

required

updatedAt

string

required

type

enum<string>

required

Identifies a turn that asserts on the agent's behavior via its attached checks.

Available options: agent

payload

object

required

Show child attributes

sequential

boolean

required

Whether the checks must pass in checkOrder rather than in any order.

checkOrder

string[]

required

The IDs of the turn's checks, in evaluation order.

Option 3

Show child attributes

string

required

testID

string

required

The ID of the test this turn belongs to.

createdAt

string

required

updatedAt

string

required

type

enum<string>

required

Identifies a turn that hands off to an LLM-driven persona conversation.

Available options: simulation

payload

object

required

Show child attributes

scenario

string

required

maxTurns

number

required

variableStates

object

required

Show child attributes

Option 1

string

Option 2

PersonaItem — see its attributes above

successCriteria

string

required

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks

List turns

Authorizations

Query Parameters

Response

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks