curl --request PATCH \
--url https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions/{id} \
--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/{id}"
payload = { "name": "Before translation step changes" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
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/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
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/{id}"
payload := strings.NewReader("{\n \"name\": \"Before translation step changes\"\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions/{id}")
.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/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.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
}{
"code": "bad_request",
"detail": "The request is malformed, for example its body isn't valid JSON.",
"status": 400,
"title": "Bad Request",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#bad_request"
}{
"code": "unauthorized",
"detail": "The request has no valid Phrase Platform JWT issued for Orchestrator. Send one as `Authorization: Bearer <JWT>`.",
"status": 401,
"title": "Unauthorized",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#unauthorized"
}{
"code": "forbidden",
"detail": "The authenticated user isn't allowed to perform this action on the resource.",
"status": 403,
"title": "Forbidden",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#forbidden"
}{
"code": "not_found",
"detail": "The resource doesn't exist, or the authenticated user can't access it.",
"status": 404,
"title": "Not Found",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#not_found"
}{
"code": "request_timeout",
"detail": "The request body arrived too slowly. Retry the request.",
"status": 408,
"title": "Request Timeout",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#request_timeout"
}{
"code": "content_too_large",
"detail": "The request body is larger than 8 MB.",
"status": 413,
"title": "Request Entity Too Large",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#content_too_large"
}{
"code": "unprocessable_content",
"detail": "A parameter doesn't match its schema, or the change isn't allowed in the resource's current state. Each entry in `errors` describes one cause.",
"errors": [
{
"detail": "Only locked revisions can be renamed. Create a new revision with POST /workflows/{workflow_id}/revisions to lock the latest one under a name."
}
],
"status": 422,
"title": "Unprocessable Content",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#unprocessable_content"
}{
"code": "rate_limited",
"detail": "This user's limit of 1000 requests per 300 seconds is used up. Retry in 42 seconds.",
"status": 429,
"title": "Too Many Requests",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#rate_limited"
}{
"code": "internal_server_error",
"detail": "Orchestrator failed unexpectedly. A write may or may not have been applied, so check the resource before retrying it.",
"status": 500,
"title": "Internal Server Error",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#internal_server_error"
}Rename a locked revision
Renames a locked revision without locking or copying anything. A revision is locked once it has been published or superseded by a newer revision. To lock the editable latest revision under a name, create a new revision with POST /workflows/{workflow_id}/revisions instead.
curl --request PATCH \
--url https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions/{id} \
--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/{id}"
payload = { "name": "Before translation step changes" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
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/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
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/{id}"
payload := strings.NewReader("{\n \"name\": \"Before translation step changes\"\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/revisions/{id}")
.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/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.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
}{
"code": "bad_request",
"detail": "The request is malformed, for example its body isn't valid JSON.",
"status": 400,
"title": "Bad Request",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#bad_request"
}{
"code": "unauthorized",
"detail": "The request has no valid Phrase Platform JWT issued for Orchestrator. Send one as `Authorization: Bearer <JWT>`.",
"status": 401,
"title": "Unauthorized",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#unauthorized"
}{
"code": "forbidden",
"detail": "The authenticated user isn't allowed to perform this action on the resource.",
"status": 403,
"title": "Forbidden",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#forbidden"
}{
"code": "not_found",
"detail": "The resource doesn't exist, or the authenticated user can't access it.",
"status": 404,
"title": "Not Found",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#not_found"
}{
"code": "request_timeout",
"detail": "The request body arrived too slowly. Retry the request.",
"status": 408,
"title": "Request Timeout",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#request_timeout"
}{
"code": "content_too_large",
"detail": "The request body is larger than 8 MB.",
"status": 413,
"title": "Request Entity Too Large",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#content_too_large"
}{
"code": "unprocessable_content",
"detail": "A parameter doesn't match its schema, or the change isn't allowed in the resource's current state. Each entry in `errors` describes one cause.",
"errors": [
{
"detail": "Only locked revisions can be renamed. Create a new revision with POST /workflows/{workflow_id}/revisions to lock the latest one under a name."
}
],
"status": 422,
"title": "Unprocessable Content",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#unprocessable_content"
}{
"code": "rate_limited",
"detail": "This user's limit of 1000 requests per 300 seconds is used up. Retry in 42 seconds.",
"status": 429,
"title": "Too Many Requests",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#rate_limited"
}{
"code": "internal_server_error",
"detail": "Orchestrator failed unexpectedly. A write may or may not have been applied, so check the resource before retrying it.",
"status": 500,
"title": "Internal Server Error",
"type": "https://developers.phrase.com/en/api/orchestrator/errors#internal_server_error"
}Authorizations
A Phrase Platform JWT issued for Orchestrator, sent as Authorization: Bearer <JWT>. See Authentication and access for how to obtain one.
Path Parameters
Body
Revision attributes to change
Response
OK
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?