Voiceflow bearer token
Split workflow block
curl --request POST \
--url https://realtime-api.voiceflow.com/v1/stable/workflow/<workflowID>/block/<blockID>/split \
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json' \
--data '{
"atStepID": "<string>",
"name": "<string>",
"expectedSteps": [
"<string>"
],
"acknowledgeRewire": true
}'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/workflow/<workflowID>/block/<blockID>/split?projectID=<projectID>&environmentAlias=<environmentAlias>', {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"atStepID": "<string>",
"name": "<string>",
"expectedSteps": [
"<string>"
],
"acknowledgeRewire": true
}),
});
const data = await response.json();import requests
response = requests.post(
'https://realtime-api.voiceflow.com/v1/stable/workflow/<workflowID>/block/<blockID>/split?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
json={
"atStepID": "<string>",
"name": "<string>",
"expectedSteps": [
"<string>"
],
"acknowledgeRewire": True
},
)
data = response.json()vf workflow split-block --workflow-id <workflowID> --block-id <blockID> --project-id <projectID> --environment-alias <environmentAlias> \
< body.json{
"head": {
"id": "<string>",
"name": "<string>",
"inboundFrom": [
{
"stepID": "<string>",
"port": "<string>"
}
],
"steps": [
{
"id": "<string>",
"kind": "<StableWorkflowStepKind>",
"exitClass": "<StableWorkflowExitClass>",
"content": "<StableWorkflowStepContent>",
"fallsThroughTo": "<string>",
"suppressedPorts": [
"<string>"
],
"links": [
"<StableWorkflowLink>"
],
"reconciledPorts": "<StableWorkflowReconciledPorts>",
"warnings": [
"<StableWorkflowDiagnostic>"
]
}
]
},
"tail": {
"id": "<string>",
"name": "<string>",
"inboundFrom": [
{
"stepID": "<string>",
"port": "<string>"
}
],
"steps": [
{
"id": "<string>",
"kind": "<StableWorkflowStepKind>",
"exitClass": "<StableWorkflowExitClass>",
"content": "<StableWorkflowStepContent>",
"fallsThroughTo": "<string>",
"suppressedPorts": [
"<string>"
],
"links": [
"<StableWorkflowLink>"
],
"reconciledPorts": "<StableWorkflowReconciledPorts>",
"warnings": [
"<StableWorkflowDiagnostic>"
]
}
]
},
"clearedLinks": [
{
"stepID": "<string>",
"port": "<string>",
"to": "<string>",
"actions": [
"<string>"
]
}
]
}Divides one block into two at a step you choose, so a link can enter at that step or a step can branch. Send `expectedSteps` as your last read returned them; if the block changed since then, the call returns 409 and writes nothing.
POST
/v1/stable/workflow/{workflowID}/block/{blockID}/split
Split workflow block
curl --request POST \
--url https://realtime-api.voiceflow.com/v1/stable/workflow/<workflowID>/block/<blockID>/split \
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json' \
--data '{
"atStepID": "<string>",
"name": "<string>",
"expectedSteps": [
"<string>"
],
"acknowledgeRewire": true
}'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/workflow/<workflowID>/block/<blockID>/split?projectID=<projectID>&environmentAlias=<environmentAlias>', {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"atStepID": "<string>",
"name": "<string>",
"expectedSteps": [
"<string>"
],
"acknowledgeRewire": true
}),
});
const data = await response.json();import requests
response = requests.post(
'https://realtime-api.voiceflow.com/v1/stable/workflow/<workflowID>/block/<blockID>/split?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
json={
"atStepID": "<string>",
"name": "<string>",
"expectedSteps": [
"<string>"
],
"acknowledgeRewire": True
},
)
data = response.json()vf workflow split-block --workflow-id <workflowID> --block-id <blockID> --project-id <projectID> --environment-alias <environmentAlias> \
< body.json{
"head": {
"id": "<string>",
"name": "<string>",
"inboundFrom": [
{
"stepID": "<string>",
"port": "<string>"
}
],
"steps": [
{
"id": "<string>",
"kind": "<StableWorkflowStepKind>",
"exitClass": "<StableWorkflowExitClass>",
"content": "<StableWorkflowStepContent>",
"fallsThroughTo": "<string>",
"suppressedPorts": [
"<string>"
],
"links": [
"<StableWorkflowLink>"
],
"reconciledPorts": "<StableWorkflowReconciledPorts>",
"warnings": [
"<StableWorkflowDiagnostic>"
]
}
]
},
"tail": {
"id": "<string>",
"name": "<string>",
"inboundFrom": [
{
"stepID": "<string>",
"port": "<string>"
}
],
"steps": [
{
"id": "<string>",
"kind": "<StableWorkflowStepKind>",
"exitClass": "<StableWorkflowExitClass>",
"content": "<StableWorkflowStepContent>",
"fallsThroughTo": "<string>",
"suppressedPorts": [
"<string>"
],
"links": [
"<StableWorkflowLink>"
],
"reconciledPorts": "<StableWorkflowReconciledPorts>",
"warnings": [
"<StableWorkflowDiagnostic>"
]
}
]
},
"clearedLinks": [
{
"stepID": "<string>",
"port": "<string>",
"to": "<string>",
"actions": [
"<string>"
]
}
]
}Authorizations
Query Parameters
Body
Response
201 - application/jsonReturns both blocks, head for the part that keeps the original ID and tail for the new one. Link a port to the tail block next.
Show child attributes
The steps in the order they run.
Show child attributes
What the step does. api, function, integration and mcp are Tool steps. playbook and operator are Agent steps. goToBlock jumps to a block or a workflow start and ends the path. callForward transfers a phone call and ends the path. legacy is a step these operations show but cannot change.
Available options:
message, end, set, workflow, listen, condition, buttons, card, carousel, code, api, function, integration, mcp, playbook, operator, crew, handoff, legacy, goToBlock, callForwardHow the step leaves. sequential: it continues to the step below it, or through next when it is last. branch: it leaves through one of its links, so it must be last. async-branch: a Card or Carousel, whose linked buttons run from any position. terminal: it ends the path.
Available options:
sequential, branch, async-branch, terminalThe step's settings, shaped by its kind. A step these operations cannot show reads as readOnly.
Show child attributes
Option 1 · StableWorkflowStepMessageContent
Show child attributes
Option 1
object · 3 attributes:
responseType, messageID, waitForUserResponseOption 2
object · 3 attributes:
responseType, promptID, waitForUserResponseOption 2 · StableWorkflowStepEndContent
Show child attributes
Option 1
object · 3 attributes:
responseType, messageID, responseEnabledOption 2
object · 3 attributes:
responseType, promptID, responseEnabledOption 3 · StableWorkflowStepSetContent
Show child attributes
Option 4 · StableWorkflowStepWorkflowContent
Option 5 · StableWorkflowStepListenContent
Option 6 · StableWorkflowStepConditionContent
Option 7 · StableWorkflowStepButtonsContent
Option 8 · StableWorkflowStepCardContent
Show child attributes
Option 9 · StableWorkflowStepCarouselContent
Show child attributes
Option 10 · StableWorkflowStepCodeContent
Option 11 · StableWorkflowStepApiContent
Show child attributes
Option 12 · StableWorkflowStepFunctionContent
Show child attributes
Option 13 · StableWorkflowStepIntegrationContent
Show child attributes
Option 14 · StableWorkflowStepMcpContent
Show child attributes
Option 15 · StableWorkflowStepOperatorContent
Show child attributes
Option 16 · StableWorkflowStepPlaybookContent
Show child attributes
Option 17 · StableWorkflowStepCrewContent
Show child attributes
Option 18 · StableWorkflowStepHandoffContent
Show child attributes
Option 19 · StableWorkflowStepGoToBlockContent
Show child attributes
Option 20 · StableWorkflowStepCallForwardContent
Show child attributes
Plain text; markdown is not interpreted. {variable_name} inserts a variable or entity, {variable_name.path} a field of a variable. Escape a literal { or \ with a backslash. A name matching neither is stored as literal text and reported in unresolvedReferences; secrets are not available here.
Show child attributes
The port actions this exit runs, in order, before it reaches to.
Show child attributes
What the step does. api, function, integration and mcp are Tool steps. playbook and operator are Agent steps. goToBlock jumps to a block or a workflow start and ends the path. callForward transfers a phone call and ends the path. legacy is a step these operations show but cannot change.
Available options:
message, end, set, workflow, listen, condition, buttons, card, carousel, code, api, function, integration, mcp, playbook, operator, crew, handoff, legacy, goToBlock, callForwardStableWorkflowStepKind — see its attributes above
The step's settings, shaped by its kind. A step these operations cannot show reads as readOnly.
StableWorkflowStepContent — see its attributes above
StableWorkflowDiagnostic — see its attributes above
StableWorkflowBlock — see its attributes above
Actions on the next exit of the head’s new last step that were deleted, because next now links to the new block. Its hidden links are kept and now run.
Show child attributes
Was this page helpful?
Thanks for your feedback.