Objective
This article shows you how to view and edit the raw JSON definition of an existing Studio flow, which is useful for bulk edits, copying a definition out of the flow, or fixing something faster than clicking through the canvas.
Product
Studio
Environment
Twilio Console
User Account Permission/Role(s) Required
Viewing the definition requires the Studio flows read permission on the account. Editing it requires the Studio flows create and update permissions; with read-only access the editor is disabled.
Procedure
- In the Twilio Console, select Orchestration in the left sidebar.
- Select Studio, then Flows.
- Select the flow you want to edit.
- Select the Details tab. The Flow definition editor appears beside the Flow details form, with line numbers.
- Edit the JSON in place. Validation runs as you type.
- Select Save.
- A Flow details saved successfully confirmation appears and the editor reformats to the saved definition.
Additional Information
- The definition must pass validation before it can be saved. Possible messages are:
- Flow definition cannot be empty.
- Invalid JSON. Please check your flow definition.
- Invalid flow definition structure. Ensure it contains required fields and a trigger state.
- Saving stores the flow as a draft. Select Publish to make the edited definition live.
- The Flow definition editor is hidden while you have unsaved changes pending on the Editor tab, so that the two views cannot fall out of step. Return to the flow after those changes settle to edit the definition.
This content was generated by AI and reviewed, edited, and verified by a human.