curl --request POST \
--url https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/executions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"payload": {
"project": {
"uid": "aBcD1234"
}
}
}
'import requests
url = "https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/executions"
payload = { "payload": { "project": { "uid": "aBcD1234" } } }
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({payload: {project: {uid: 'aBcD1234'}}})
};
fetch('https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/executions', 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}/executions",
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([
'payload' => [
'project' => [
'uid' => 'aBcD1234'
]
]
]),
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}/executions"
payload := strings.NewReader("{\n \"payload\": {\n \"project\": {\n \"uid\": \"aBcD1234\"\n }\n }\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}/executions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"payload\": {\n \"project\": {\n \"uid\": \"aBcD1234\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/executions")
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 \"payload\": {\n \"project\": {\n \"uid\": \"aBcD1234\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"finished_at": "2026-07-30T02:04:12.000000Z",
"id": 91,
"manual": false,
"name": "789-20260730_020000-1a2b3c4d",
"revision_id": 17,
"started_at": "2026-07-30T02:00:00.000000Z",
"status": "succeeded",
"task_count": 3,
"url": "https://eu.phrase.com/orchestrator/manage/workflows/8/executions/91",
"workflow_id": 8
}Run a workflow
Queues a new execution of the workflow’s latest revision, independent of its trigger, and returns it as pending. The run executes the workflow’s real actions, with the same side effects as a triggered run (jobs created, messages sent), and consumes the owner’s actions-executed quota; it is rejected with 422 once that quota is used up. It starts once the organization’s earlier queued executions have started, and can stay pending while the organization is at its concurrent execution limit. The revision must pass the same validation as publishing, but doesn’t need to be published. Only workflows with an owner can be run, not action bundles or templates. Follow the run with GET /executions/{id}. Idempotency keys are not supported: retrying a request that timed out can create a duplicate, so check whether the first attempt succeeded before retrying. Executions created by an older engine version are not addressable.
curl --request POST \
--url https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/executions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"payload": {
"project": {
"uid": "aBcD1234"
}
}
}
'import requests
url = "https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/executions"
payload = { "payload": { "project": { "uid": "aBcD1234" } } }
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({payload: {project: {uid: 'aBcD1234'}}})
};
fetch('https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/executions', 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}/executions",
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([
'payload' => [
'project' => [
'uid' => 'aBcD1234'
]
]
]),
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}/executions"
payload := strings.NewReader("{\n \"payload\": {\n \"project\": {\n \"uid\": \"aBcD1234\"\n }\n }\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}/executions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"payload\": {\n \"project\": {\n \"uid\": \"aBcD1234\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://eu.phrase.com/orchestrator/api/v1/workflows/{workflow_id}/executions")
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 \"payload\": {\n \"project\": {\n \"uid\": \"aBcD1234\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"finished_at": "2026-07-30T02:04:12.000000Z",
"id": 91,
"manual": false,
"name": "789-20260730_020000-1a2b3c4d",
"revision_id": 17,
"started_at": "2026-07-30T02:00:00.000000Z",
"status": "succeeded",
"task_count": 3,
"url": "https://eu.phrase.com/orchestrator/manage/workflows/8/executions/91",
"workflow_id": 8
}Authorizations
A Phrase Platform JWT issued for Orchestrator, sent as Authorization: Bearer <JWT>. See Authentication and access for how to obtain one.
Body
Run options
Request body for running the workflow's latest revision on demand.
Response
Created
A single run of a workflow.
Was this page helpful?