Voiceflow bearer token
Merge environments
curl --request PUT \
--url https://realtime-api.voiceflow.com/v1/stable/environment/merge \
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json' \
--data '{
"sourceEnvironmentAlias": "<string>",
"targetEnvironmentAlias": "<string>",
"removeSourceEnvironment": false
}'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/environment/merge?projectID=<projectID>', {
method: 'PUT',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"sourceEnvironmentAlias": "<string>",
"targetEnvironmentAlias": "<string>",
"removeSourceEnvironment": false
}),
});
const data = await response.json();import requests
response = requests.put(
'https://realtime-api.voiceflow.com/v1/stable/environment/merge?projectID=<projectID>',
headers={'Authorization': 'Bearer <token>'},
json={
"sourceEnvironmentAlias": "<string>",
"targetEnvironmentAlias": "<string>",
"removeSourceEnvironment": False
},
)
data = response.json()vf environment merge --project-id <projectID> \
< body.json{
"sourceEnvironment": {
"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
},
"targetEnvironment": {
"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
},
"targetRelease": {
"name": "<string>",
"backupID": 0,
"createdAt": "2026-09-10T00:00:00.000Z",
"description": "<string>",
"autogenerated": true
}
}Merge environments
Folds the contents of one environment into another, so work done in a clone can be brought back to the environment it was cloned from.
PUT
/v1/stable/environment/merge
Merge environments
curl --request PUT \
--url https://realtime-api.voiceflow.com/v1/stable/environment/merge \
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json' \
--data '{
"sourceEnvironmentAlias": "<string>",
"targetEnvironmentAlias": "<string>",
"removeSourceEnvironment": false
}'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/environment/merge?projectID=<projectID>', {
method: 'PUT',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"sourceEnvironmentAlias": "<string>",
"targetEnvironmentAlias": "<string>",
"removeSourceEnvironment": false
}),
});
const data = await response.json();import requests
response = requests.put(
'https://realtime-api.voiceflow.com/v1/stable/environment/merge?projectID=<projectID>',
headers={'Authorization': 'Bearer <token>'},
json={
"sourceEnvironmentAlias": "<string>",
"targetEnvironmentAlias": "<string>",
"removeSourceEnvironment": False
},
)
data = response.json()vf environment merge --project-id <projectID> \
< body.json{
"sourceEnvironment": {
"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
},
"targetEnvironment": {
"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
},
"targetRelease": {
"name": "<string>",
"backupID": 0,
"createdAt": "2026-09-10T00:00:00.000Z",
"description": "<string>",
"autogenerated": true
}
}Authorizations
Body
Response
200 - application/jsonReturns the source and target environments as they stand after the merge, plus the resulting release on the target, with its name, description, and the ID of the backup that snapshots it.
Show child attributes
Show child attributes
StableEnvironment — see its attributes above
Show child attributes
Was this page helpful?
Thanks for your feedback.