List spans
curl --request POST \
--url https://api.getcargo.io/v1/orchestration/spans/list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"executionStartedAfter": "<string>",
"workflowUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"userUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"batchUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"traceUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"recordId": "<string>",
"recordTitle": "<string>",
"recordTitleOrId": "<string>",
"search": "<string>",
"parentRunUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parentNodeUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parentAgentUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeSlug": "<string>",
"nodeIntegrationSlug": "<string>",
"nodeConnectorUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeActionSlug": "<string>",
"nodeToolUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeAgentUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeWorkerUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeReleaseUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"executionTitle": "<string>",
"executionTitleOrErrorMessage": "<string>",
"executionStatuses": [],
"executionStartedBefore": "<string>",
"limit": 123,
"offset": 123
}
'import requests
url = "https://api.getcargo.io/v1/orchestration/spans/list"
payload = {
"executionStartedAfter": "<string>",
"workflowUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"userUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"batchUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"traceUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"recordId": "<string>",
"recordTitle": "<string>",
"recordTitleOrId": "<string>",
"search": "<string>",
"parentRunUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parentNodeUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parentAgentUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeSlug": "<string>",
"nodeIntegrationSlug": "<string>",
"nodeConnectorUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeActionSlug": "<string>",
"nodeToolUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeAgentUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeWorkerUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeReleaseUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"executionTitle": "<string>",
"executionTitleOrErrorMessage": "<string>",
"executionStatuses": [],
"executionStartedBefore": "<string>",
"limit": 123,
"offset": 123
}
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({
executionStartedAfter: '<string>',
workflowUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
userUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
batchUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
traceUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
runUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
recordId: '<string>',
recordTitle: '<string>',
recordTitleOrId: '<string>',
search: '<string>',
parentRunUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
parentNodeUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
parentAgentUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeSlug: '<string>',
nodeIntegrationSlug: '<string>',
nodeConnectorUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeActionSlug: '<string>',
nodeToolUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeAgentUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeWorkerUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeReleaseUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
executionTitle: '<string>',
executionTitleOrErrorMessage: '<string>',
executionStatuses: [],
executionStartedBefore: '<string>',
limit: 123,
offset: 123
})
};
fetch('https://api.getcargo.io/v1/orchestration/spans/list', 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://api.getcargo.io/v1/orchestration/spans/list",
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([
'executionStartedAfter' => '<string>',
'workflowUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'userUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'batchUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'traceUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'runUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'recordId' => '<string>',
'recordTitle' => '<string>',
'recordTitleOrId' => '<string>',
'search' => '<string>',
'parentRunUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'parentNodeUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'parentAgentUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeSlug' => '<string>',
'nodeIntegrationSlug' => '<string>',
'nodeConnectorUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeActionSlug' => '<string>',
'nodeToolUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeAgentUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeWorkerUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeReleaseUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'executionTitle' => '<string>',
'executionTitleOrErrorMessage' => '<string>',
'executionStatuses' => [
],
'executionStartedBefore' => '<string>',
'limit' => 123,
'offset' => 123
]),
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://api.getcargo.io/v1/orchestration/spans/list"
payload := strings.NewReader("{\n \"executionStartedAfter\": \"<string>\",\n \"workflowUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"batchUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"traceUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"recordId\": \"<string>\",\n \"recordTitle\": \"<string>\",\n \"recordTitleOrId\": \"<string>\",\n \"search\": \"<string>\",\n \"parentRunUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentNodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeSlug\": \"<string>\",\n \"nodeIntegrationSlug\": \"<string>\",\n \"nodeConnectorUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeActionSlug\": \"<string>\",\n \"nodeToolUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeWorkerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeReleaseUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"executionTitle\": \"<string>\",\n \"executionTitleOrErrorMessage\": \"<string>\",\n \"executionStatuses\": [],\n \"executionStartedBefore\": \"<string>\",\n \"limit\": 123,\n \"offset\": 123\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://api.getcargo.io/v1/orchestration/spans/list")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"executionStartedAfter\": \"<string>\",\n \"workflowUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"batchUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"traceUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"recordId\": \"<string>\",\n \"recordTitle\": \"<string>\",\n \"recordTitleOrId\": \"<string>\",\n \"search\": \"<string>\",\n \"parentRunUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentNodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeSlug\": \"<string>\",\n \"nodeIntegrationSlug\": \"<string>\",\n \"nodeConnectorUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeActionSlug\": \"<string>\",\n \"nodeToolUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeWorkerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeReleaseUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"executionTitle\": \"<string>\",\n \"executionTitleOrErrorMessage\": \"<string>\",\n \"executionStatuses\": [],\n \"executionStartedBefore\": \"<string>\",\n \"limit\": 123,\n \"offset\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getcargo.io/v1/orchestration/spans/list")
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 \"executionStartedAfter\": \"<string>\",\n \"workflowUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"batchUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"traceUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"recordId\": \"<string>\",\n \"recordTitle\": \"<string>\",\n \"recordTitleOrId\": \"<string>\",\n \"search\": \"<string>\",\n \"parentRunUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentNodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeSlug\": \"<string>\",\n \"nodeIntegrationSlug\": \"<string>\",\n \"nodeConnectorUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeActionSlug\": \"<string>\",\n \"nodeToolUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeWorkerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeReleaseUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"executionTitle\": \"<string>\",\n \"executionTitleOrErrorMessage\": \"<string>\",\n \"executionStatuses\": [],\n \"executionStartedBefore\": \"<string>\",\n \"limit\": 123,\n \"offset\": 123\n}"
response = http.request(request)
puts response.read_body{
"spans": [
{
"workspaceUuid": "<string>",
"workflowUuid": "<string>",
"userUuid": "<string>",
"batchUuid": "<string>",
"traceUuid": "<string>",
"recordId": "<string>",
"recordTitle": "<string>",
"runUuid": "<string>",
"runContextS3Filename": "<string>",
"runComputedConfigsS3Filename": "<string>",
"parentRunUuid": "<string>",
"parentNodeUuid": "<string>",
"parentBatchUuid": "<string>",
"parentAgentUuid": "<string>",
"parentChatUuid": "<string>",
"parentMessageUuid": "<string>",
"isGroupParent": true,
"nodeUuid": "<string>",
"nodeKind": "native",
"nodeSlug": "<string>",
"nodeActionSlug": "<string>",
"nodeConnectorUuid": "<string>",
"nodeIntegrationSlug": "<string>",
"nodeToolUuid": "<string>",
"nodeAgentUuid": "<string>",
"nodeWorkerUuid": "<string>",
"nodeReleaseUuid": "<string>",
"nodeBatchUuid": "<string>",
"nodeRunUuid": "<string>",
"nodeMessageUuid": "<string>",
"nodeChildIndex": 123,
"nodeWaitUntilFinished": true,
"nodeNextUuid": "<string>",
"executionIndex": 123,
"executionStatus": "pending",
"executionErrorMessage": "<string>",
"executionTitle": "<string>",
"executionIconUrl": "<string>",
"executionCreditsUsedCount": 123,
"executionStartedAt": "<string>",
"executionUpdatedAt": "<string>",
"executionFinishedAt": "<string>"
}
],
"count": 123
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}Orchestration - Spans
List spans
List flattened execution spans for orchestration runs (one row per executed node within a run) (POST /orchestration/spans/list).
POST
/
orchestration
/
spans
/
list
List spans
curl --request POST \
--url https://api.getcargo.io/v1/orchestration/spans/list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"executionStartedAfter": "<string>",
"workflowUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"userUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"batchUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"traceUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"recordId": "<string>",
"recordTitle": "<string>",
"recordTitleOrId": "<string>",
"search": "<string>",
"parentRunUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parentNodeUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parentAgentUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeSlug": "<string>",
"nodeIntegrationSlug": "<string>",
"nodeConnectorUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeActionSlug": "<string>",
"nodeToolUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeAgentUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeWorkerUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeReleaseUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"executionTitle": "<string>",
"executionTitleOrErrorMessage": "<string>",
"executionStatuses": [],
"executionStartedBefore": "<string>",
"limit": 123,
"offset": 123
}
'import requests
url = "https://api.getcargo.io/v1/orchestration/spans/list"
payload = {
"executionStartedAfter": "<string>",
"workflowUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"userUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"batchUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"traceUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"recordId": "<string>",
"recordTitle": "<string>",
"recordTitleOrId": "<string>",
"search": "<string>",
"parentRunUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parentNodeUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parentAgentUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeSlug": "<string>",
"nodeIntegrationSlug": "<string>",
"nodeConnectorUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeActionSlug": "<string>",
"nodeToolUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeAgentUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeWorkerUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"nodeReleaseUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"executionTitle": "<string>",
"executionTitleOrErrorMessage": "<string>",
"executionStatuses": [],
"executionStartedBefore": "<string>",
"limit": 123,
"offset": 123
}
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({
executionStartedAfter: '<string>',
workflowUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
userUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
batchUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
traceUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
runUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
recordId: '<string>',
recordTitle: '<string>',
recordTitleOrId: '<string>',
search: '<string>',
parentRunUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
parentNodeUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
parentAgentUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeSlug: '<string>',
nodeIntegrationSlug: '<string>',
nodeConnectorUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeActionSlug: '<string>',
nodeToolUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeAgentUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeWorkerUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
nodeReleaseUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
executionTitle: '<string>',
executionTitleOrErrorMessage: '<string>',
executionStatuses: [],
executionStartedBefore: '<string>',
limit: 123,
offset: 123
})
};
fetch('https://api.getcargo.io/v1/orchestration/spans/list', 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://api.getcargo.io/v1/orchestration/spans/list",
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([
'executionStartedAfter' => '<string>',
'workflowUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'userUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'batchUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'traceUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'runUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'recordId' => '<string>',
'recordTitle' => '<string>',
'recordTitleOrId' => '<string>',
'search' => '<string>',
'parentRunUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'parentNodeUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'parentAgentUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeSlug' => '<string>',
'nodeIntegrationSlug' => '<string>',
'nodeConnectorUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeActionSlug' => '<string>',
'nodeToolUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeAgentUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeWorkerUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'nodeReleaseUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'executionTitle' => '<string>',
'executionTitleOrErrorMessage' => '<string>',
'executionStatuses' => [
],
'executionStartedBefore' => '<string>',
'limit' => 123,
'offset' => 123
]),
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://api.getcargo.io/v1/orchestration/spans/list"
payload := strings.NewReader("{\n \"executionStartedAfter\": \"<string>\",\n \"workflowUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"batchUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"traceUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"recordId\": \"<string>\",\n \"recordTitle\": \"<string>\",\n \"recordTitleOrId\": \"<string>\",\n \"search\": \"<string>\",\n \"parentRunUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentNodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeSlug\": \"<string>\",\n \"nodeIntegrationSlug\": \"<string>\",\n \"nodeConnectorUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeActionSlug\": \"<string>\",\n \"nodeToolUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeWorkerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeReleaseUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"executionTitle\": \"<string>\",\n \"executionTitleOrErrorMessage\": \"<string>\",\n \"executionStatuses\": [],\n \"executionStartedBefore\": \"<string>\",\n \"limit\": 123,\n \"offset\": 123\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://api.getcargo.io/v1/orchestration/spans/list")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"executionStartedAfter\": \"<string>\",\n \"workflowUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"batchUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"traceUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"recordId\": \"<string>\",\n \"recordTitle\": \"<string>\",\n \"recordTitleOrId\": \"<string>\",\n \"search\": \"<string>\",\n \"parentRunUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentNodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeSlug\": \"<string>\",\n \"nodeIntegrationSlug\": \"<string>\",\n \"nodeConnectorUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeActionSlug\": \"<string>\",\n \"nodeToolUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeWorkerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeReleaseUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"executionTitle\": \"<string>\",\n \"executionTitleOrErrorMessage\": \"<string>\",\n \"executionStatuses\": [],\n \"executionStartedBefore\": \"<string>\",\n \"limit\": 123,\n \"offset\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getcargo.io/v1/orchestration/spans/list")
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 \"executionStartedAfter\": \"<string>\",\n \"workflowUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"batchUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"traceUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"recordId\": \"<string>\",\n \"recordTitle\": \"<string>\",\n \"recordTitleOrId\": \"<string>\",\n \"search\": \"<string>\",\n \"parentRunUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentNodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"parentAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeSlug\": \"<string>\",\n \"nodeIntegrationSlug\": \"<string>\",\n \"nodeConnectorUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeActionSlug\": \"<string>\",\n \"nodeToolUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeAgentUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeWorkerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"nodeReleaseUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"executionTitle\": \"<string>\",\n \"executionTitleOrErrorMessage\": \"<string>\",\n \"executionStatuses\": [],\n \"executionStartedBefore\": \"<string>\",\n \"limit\": 123,\n \"offset\": 123\n}"
response = http.request(request)
puts response.read_body{
"spans": [
{
"workspaceUuid": "<string>",
"workflowUuid": "<string>",
"userUuid": "<string>",
"batchUuid": "<string>",
"traceUuid": "<string>",
"recordId": "<string>",
"recordTitle": "<string>",
"runUuid": "<string>",
"runContextS3Filename": "<string>",
"runComputedConfigsS3Filename": "<string>",
"parentRunUuid": "<string>",
"parentNodeUuid": "<string>",
"parentBatchUuid": "<string>",
"parentAgentUuid": "<string>",
"parentChatUuid": "<string>",
"parentMessageUuid": "<string>",
"isGroupParent": true,
"nodeUuid": "<string>",
"nodeKind": "native",
"nodeSlug": "<string>",
"nodeActionSlug": "<string>",
"nodeConnectorUuid": "<string>",
"nodeIntegrationSlug": "<string>",
"nodeToolUuid": "<string>",
"nodeAgentUuid": "<string>",
"nodeWorkerUuid": "<string>",
"nodeReleaseUuid": "<string>",
"nodeBatchUuid": "<string>",
"nodeRunUuid": "<string>",
"nodeMessageUuid": "<string>",
"nodeChildIndex": 123,
"nodeWaitUntilFinished": true,
"nodeNextUuid": "<string>",
"executionIndex": 123,
"executionStatus": "pending",
"executionErrorMessage": "<string>",
"executionTitle": "<string>",
"executionIconUrl": "<string>",
"executionCreditsUsedCount": 123,
"executionStartedAt": "<string>",
"executionUpdatedAt": "<string>",
"executionFinishedAt": "<string>"
}
],
"count": 123
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}Authorizations
bearerAuthoauth2
API token from cargo-ai login. Send as Authorization: Bearer <token>.
Headers
Client-generated key that makes this write safe to retry. Reusing the same key with the same request returns the original response instead of creating a second record. Reusing it with a different request returns 422. A concurrent retry while the first request is still running returns 409. Keys expire after 24 hours. Not accepted on multipart file uploads. Optional: a request without one is processed as it always was.
Maximum string length:
255Example:
"8e03978e-40d5-43e8-bc93-6894a57f9324"
Body
application/json
Request body schema.
Include spans whose execution started after this timestamp (ISO string). Required.
When set, restrict spans to this workflow. Omit to search across workflows in the workspace.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$User identifier to filter by.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Batch identifier to filter by.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Trace identifier to filter by. Returns every span across the trace's run lineage. Raises the maximum limit to 1000 so a whole trace can be fetched in one request.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Run identifier to filter by.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Record ID to filter by.
Record title to filter by (SQL ilike).
Match record id or record title (each SQL ilike); same pattern as run list.
Case-insensitive partial match on record title, record ID, execution title, or error message.
Minimum string length:
1Parent run identifier to filter by.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Filter by parent node UUID on the run.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$When set, restrict spans to rows whose parent agent matches this UUID.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Node identifier to filter by.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Filter by node kind (native, connector, tool, agent).
Available options:
native, connector, tool, agent, worker Filter by workflow node slug (exact match).
Filter by connector integration slug (exact match).
Filter by connector UUID.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Filter by node action slug (exact match).
Filter by tool node UUID.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Filter by agent node UUID.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Filter by hosted worker UUID on the span.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Filter by release UUID referenced on the node.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Filter by execution title (SQL ilike).
Match execution title or execution error message (each SQL ilike).
Execution statuses to include.
Available options:
pending, success, error Include spans whose execution started on or before this timestamp (ISO string).
Maximum number of spans to return.
Number of spans to skip.
Was this page helpful?