curl --request POST \
--url https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Before translation step changes"
}
'import requests
url = "https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions"
payload = { "name": "Before translation step changes" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Before translation step changes'})
};
fetch('https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Before translation step changes'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions"
payload := strings.NewReader("{\n \"name\": \"Before translation step changes\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Before translation step changes\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Before translation step changes\"\n}"
response = http.request(request)
puts response.read_body{
"id": 314,
"inserted_at": "2026-01-14T11:02:11.000000Z",
"locked_at": "2026-01-15T09:30:00.000000Z",
"name": "Revision 2",
"paused_at": null,
"published_at": "2026-01-15T09:30:00.000000Z",
"sequence": 2,
"updated_at": "2026-01-15T09:30:00.000000Z",
"url": "https://eu.phrase.com/orchestrator/manage/workflows/42/editor/314",
"workflow_id": 42
}Create a revision
Creates a new draft revision as a copy of the workflow’s latest revision and makes it the workflow’s latest revision. The previous latest revision is locked (renamed to name when given) and stays available as a read-only restore point. Nothing is published. The new revision is a copy, so its task and trigger ids differ from the previous revision’s: re-read them before editing. Static webhook URLs of Wait for trigger actions and the workflow’s webhook URL stay the same. Use this to keep editing a workflow whose latest revision is locked, for example after publishing it. Idempotency keys are not supported: retrying a request that timed out can create a duplicate, so check whether the first attempt succeeded before retrying.
curl --request POST \
--url https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Before translation step changes"
}
'import requests
url = "https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions"
payload = { "name": "Before translation step changes" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Before translation step changes'})
};
fetch('https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Before translation step changes'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions"
payload := strings.NewReader("{\n \"name\": \"Before translation step changes\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Before translation step changes\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Before translation step changes\"\n}"
response = http.request(request)
puts response.read_body{
"id": 314,
"inserted_at": "2026-01-14T11:02:11.000000Z",
"locked_at": "2026-01-15T09:30:00.000000Z",
"name": "Revision 2",
"paused_at": null,
"published_at": "2026-01-15T09:30:00.000000Z",
"sequence": 2,
"updated_at": "2026-01-15T09:30:00.000000Z",
"url": "https://eu.phrase.com/orchestrator/manage/workflows/42/editor/314",
"workflow_id": 42
}Authorizations
A Phrase Platform JWT issued for Orchestrator, sent as Authorization: Bearer <JWT>. See Authentication and access for how to obtain one.
Body
Revision attributes
Response
Created
A versioned snapshot of a workflow's trigger and actions.
When the revision became read-only, or null for the editable latest revision. A revision is locked when it's published, or when it's saved under a name (Rename in the UI, or POST /workflows/{workflow_id}/revisions) and a new draft replaces it.
"2026-01-15T09:30:00.000000Z"
When the revision was paused, or null if it is not paused. A paused revision stays published but its workflow stops reacting to triggers. Revisions can be paused automatically when your account exceeds plan limits, such as too many actions executed or too many workflows published.
"2026-02-01T00:00:00.000000Z"
Was this page helpful?