Voiceflow bearer token
Get environment
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/environment/<environmentAlias> \
--header 'Authorization: Bearer <token>'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/environment/<environmentAlias>?projectID=<projectID>', {
method: 'GET',
headers: {
Authorization: 'Bearer <token>',
},
});
const data = await response.json();import requests
response = requests.get(
'https://realtime-api.voiceflow.com/v1/stable/environment/<environmentAlias>?projectID=<projectID>',
headers={'Authorization': 'Bearer <token>'},
)
data = response.json()vf environment get --environment-alias <environmentAlias> --project-id <projectID>{
"environment": {
"name": "<string>",
"alias": "<string>",
"isMain": true,
"releases": [
{
"name": "<string>",
"backupID": 0,
"createdAt": "2026-09-10T00:00:00.000Z",
"description": "<string>",
"autogenerated": true
}
],
"createdAt": "2026-09-10T00:00:00.000Z",
"trafficPercentage": 0
}
}Get environment
Returns a single environment by ID, with the fields that define it. An environment is one draft-and-published copy of the agent.
GET
/v1/stable/environment/{environmentAlias}
Get environment
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/environment/<environmentAlias> \
--header 'Authorization: Bearer <token>'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/environment/<environmentAlias>?projectID=<projectID>', {
method: 'GET',
headers: {
Authorization: 'Bearer <token>',
},
});
const data = await response.json();import requests
response = requests.get(
'https://realtime-api.voiceflow.com/v1/stable/environment/<environmentAlias>?projectID=<projectID>',
headers={'Authorization': 'Bearer <token>'},
)
data = response.json()vf environment get --environment-alias <environmentAlias> --project-id <projectID>{
"environment": {
"name": "<string>",
"alias": "<string>",
"isMain": true,
"releases": [
{
"name": "<string>",
"backupID": 0,
"createdAt": "2026-09-10T00:00:00.000Z",
"description": "<string>",
"autogenerated": true
}
],
"createdAt": "2026-09-10T00:00:00.000Z",
"trafficPercentage": 0
}
}Authorizations
Response
200 - application/jsonReturns the one environment the alias resolves to, including its release history and the share of live traffic routed to it.
Show child attributes
Show child attributes
Was this page helpful?
Thanks for your feedback.