Execute Workflow
curl --request POST \
--url https://api.truthlocks.com/v1/orchestrate/workflows/{workflowId}/execute \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"trigger_agent_id": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({trigger_agent_id: '<string>'})
};
fetch('https://api.truthlocks.com/v1/orchestrate/workflows/{workflowId}/execute', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/orchestrate/workflows/{workflowId}/execute"
payload = { "trigger_agent_id": "<string>" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/orchestrate/workflows/{workflowId}/execute"
payload := strings.NewReader("{\n \"trigger_agent_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
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))
}{
"execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"steps": [
{
"action": "<string>",
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>",
"result": {}
}
],
"created_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Orchestrations & Workflows
Create a MAIP Workflow Run Record
Records a run against a registered MAIP workflow.
POST
/
v1
/
orchestrate
/
workflows
/
{workflowId}
/
execute
Execute Workflow
curl --request POST \
--url https://api.truthlocks.com/v1/orchestrate/workflows/{workflowId}/execute \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"trigger_agent_id": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({trigger_agent_id: '<string>'})
};
fetch('https://api.truthlocks.com/v1/orchestrate/workflows/{workflowId}/execute', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/orchestrate/workflows/{workflowId}/execute"
payload = { "trigger_agent_id": "<string>" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/orchestrate/workflows/{workflowId}/execute"
payload := strings.NewReader("{\n \"trigger_agent_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
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))
}{
"execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"steps": [
{
"action": "<string>",
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>",
"result": {}
}
],
"created_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Records a run against a registered MAIP workflow.
Supply
trigger_agent_id, with optional input_payload and metadata. The current handler creates a run with status running and returns HTTP 201. This MAIP tracking route does not itself launch a Temporal workflow. Do not interpret the initial status as proof that workflow steps executed. Generated workflow receipts currently use system markers rather than cryptographic signatures.
Use the generated parameter fields above for the request contract. Authenticate with a credential for the target workspace and environment; do not supply a tenant-selection header.Authorizations
API key for machine-to-machine authentication
Path Parameters
Workflow identifier

