Voiceflow bearer token
Create check
curl --request POST \
--url https://realtime-api.voiceflow.com/v1/stable/test-check \
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json' \
--data '{
"type": "response",
"turnID": "<string>",
"payload": {
"type": "equal",
"value": "<string>"
}
}'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test-check?projectID=<projectID>&environmentAlias=<environmentAlias>', {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"type": "response",
"turnID": "<string>",
"payload": {
"type": "equal",
"value": "<string>"
}
}),
});
const data = await response.json();import requests
response = requests.post(
'https://realtime-api.voiceflow.com/v1/stable/test-check?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
json={
"type": "response",
"turnID": "<string>",
"payload": {
"type": "equal",
"value": "<string>"
}
},
)
data = response.json()vf test check create --project-id <projectID> --environment-alias <environmentAlias> \
< body.json{
"check": {
"id": "<string>",
"turnID": "<string>",
"createdAt": "2026-09-10T00:00:00.000Z",
"updatedAt": "2026-09-10T00:00:00.000Z",
"type": "response",
"payload": "<SimulationTurnTestJudgeEqual>"
}
}Create check
Adds a test check to its turn, one assertion about an agent turn, comparing the reply or the behaviour behind it. The response carries the ID that later calls address it by.
POST
/v1/stable/test-check
Create check
curl --request POST \
--url https://realtime-api.voiceflow.com/v1/stable/test-check \
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json' \
--data '{
"type": "response",
"turnID": "<string>",
"payload": {
"type": "equal",
"value": "<string>"
}
}'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test-check?projectID=<projectID>&environmentAlias=<environmentAlias>', {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"type": "response",
"turnID": "<string>",
"payload": {
"type": "equal",
"value": "<string>"
}
}),
});
const data = await response.json();import requests
response = requests.post(
'https://realtime-api.voiceflow.com/v1/stable/test-check?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
json={
"type": "response",
"turnID": "<string>",
"payload": {
"type": "equal",
"value": "<string>"
}
},
)
data = response.json()vf test check create --project-id <projectID> --environment-alias <environmentAlias> \
< body.json{
"check": {
"id": "<string>",
"turnID": "<string>",
"createdAt": "2026-09-10T00:00:00.000Z",
"updatedAt": "2026-09-10T00:00:00.000Z",
"type": "response",
"payload": "<SimulationTurnTestJudgeEqual>"
}
}Authorizations
Query Parameters
Body
Show child attributes
Option 1
Show child attributes
Option 2
Show child attributes
Show child attributes
The routing target to check against, paired with shouldRoute. Null when asserting no routing at all.
Option 3
Show child attributes
Response
201 - application/jsonCreates one check on the turn named in the body and returns it with its assigned id. Checks hang off agent turns, which are the turns that carry a checkOrder.
Show child attributes
Option 1
Show child attributes
ResponseSimulationTurnTestPayload — see its attributes above
Option 2
Show child attributes
Option 3
Show child attributes
ToolSimulationTurnTestPayload — see its attributes above
Was this page helpful?
Thanks for your feedback.