Runs
Get a run's debug bundle
Get a run’s debug bundle. Requires permission runs:read.
GET
/
api
/
v3
/
runs
/
{runId}
/
debug-bundle
Get a run's debug bundle
curl --request GET \
--url https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle', 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.forge.gloo.com/api/v3/runs/{runId}/debug-bundle",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"tier": "inline",
"schemaVersion": 1,
"capturedAt": 123,
"approximateSizeBytes": 1,
"bundle": {
"run": {
"id": "<string>",
"runType": "<string>",
"status": "<string>",
"interfaceId": "<string>",
"workflowId": "<string>",
"workflowVersion": 123,
"goal": "<string>",
"delegatedAgentId": "<string>",
"guardrails": "<unknown>",
"guardrailState": "<unknown>",
"args": "<unknown>",
"startedAt": 123,
"completedAt": 123,
"error": "<string>",
"totalTokens": 123,
"totalCost": 123,
"parentRunId": "<string>",
"parentStepId": "<string>",
"handlingSummary": {
"disposition": "normal",
"expectedExceptionNodeIds": [
"<string>"
],
"handledFailureNodeIds": [
"<string>"
],
"unresolvedFailureNodeIds": [
"<string>"
]
},
"executionOutcome": {
"schemaVersion": 1,
"classifierRevision": 1,
"source": "native",
"attempt": 123,
"workflowInstanceId": "<string>",
"statusAtCapture": "completed",
"coverage": "complete",
"reasonCodes": [
"not_recorded"
],
"selectedPaths": [
{
"nodeId": "<string>",
"nodeName": "<string>",
"labels": [
"<string>"
]
}
],
"omittedPathCount": 1,
"capturedAt": 123,
"summary": {
"disposition": "normal",
"expectedExceptionNodeIds": [
"<string>"
],
"handledFailureNodeIds": [
"<string>"
],
"unresolvedFailureNodeIds": [
"<string>"
]
},
"graphDigest": "<string>"
},
"executionOutcomeReadReason": "not_recorded"
},
"provenance": {
"runId": "<string>",
"kind": "production",
"workflowId": "<string>",
"workflow": {
"id": "<string>",
"name": "<string>"
},
"version": {
"id": "<string>",
"number": 123,
"status": "active",
"publishedAt": 123
},
"draft": {
"id": "<string>",
"baseVersionId": "<string>"
},
"currentAttempt": 2,
"attempts": [
2
]
},
"steps": [
{
"stepId": "<string>",
"nodeId": "<string>",
"status": "pending",
"kind": "procedure",
"agent": "<string>",
"model": "<string>",
"startedAt": 123,
"completedAt": 123,
"totalTokens": 123,
"cost": 123,
"hold": {
"state": "waiting",
"heldAt": 123,
"resolvedAt": 123,
"approvalId": "<string>",
"handoff": {
"kind": "console",
"decidedBy": "person",
"item": "<string>",
"path": "<string>",
"url": "<string>"
}
},
"outputs": "<unknown>",
"stdout": "<string>",
"error": {
"message": "<string>",
"code": "<string>",
"phase": "<string>",
"retryable": true,
"correlationId": "<string>"
},
"deliveryProgress": {
"confirmation": "queued",
"quorum": "all",
"state": "pending",
"startedAt": 123,
"deadlineAt": 123,
"required": 123,
"confirmed": 123,
"skipped": 123,
"unresolved": 123,
"safeNextAction": "wait"
}
}
],
"validatorRuns": [
{
"id": "<string>",
"attempt": 123,
"kind": "schema",
"verdict": "pass",
"feedback": "<string>",
"schemaSnapshot": "<unknown>",
"receivedOutputs": "<unknown>",
"startedAt": 123,
"completedAt": 123
}
],
"graph": {
"versionId": "<string>",
"draftId": "<string>",
"nodes": [
{
"id": "<string>",
"name": "<string>",
"type": "<string>"
}
]
}
}
},
"meta": {
"requestId": "<string>",
"partial": true,
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "bad_request",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "forbidden",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "resource_missing",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "internal_error",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}The reference panel describes the current v3 operation. The notes below describe its v2 compatibility API. Follow the v3 request schema for current calls: v3 can move identifiers from the body or query into the URL. Keep the v2 method, path, and payload together when using the compatibility API.
v2 compatibility notes
Returns the run’s debug bundle, built from the run-inspection reads so it carries exactly what they carry:run: the run asGET /api/v2/runs/getprojects it, without its steps or outputs.provenance: asGET /api/v2/runs/getProvenancereturns it.steps: each step with its outputs, stdout and error, asGET /api/v2/runs/getStepreturns it (deliveryProgressis alwaysnullhere), at most 500.validatorRuns: the run’s schema and validator-agent passes, at most 500.graph: the graph’s node identities (id,name,type, at most 500), never a prompt, routing prompt or binding.
[REDACTED] marker, and a human step’s outputs never carry who answered, the channel or the person’s response.
The workflow’s authoring data
graph and the provenance’s workflow and draft belong to the workflow, so they are null unless your scopes also reach workflows:read and your role grants hold it at the workflow’s home. That is never a refusal.
Size
tier is inline up to 1 MiB, inline_large up to 8 MiB, and too_large above that, when the body is null and meta.partial is true; approximateSizeBytes says how large it measured. No storage URL is ever returned: there is no download link to follow. meta.partial is also true when a section was cut at its bound or the step read stopped before the request’s read limit.
Visibility
You needruns:read at the run’s home (its own org unit, else its workflow’s owning org unit) and at every company it carries, the same rule as GET /api/v2/runs/get. Any other run, and a run with neither home, answers 404 “Run not found” like a missing one. A Personal key reads as its owner, cut down to the key’s scopes; an External App reads by its own role grants.
id is required; a missing id answers 404.Authorizations
BearerAuthPlatformApiKeyPersonalKey
⌘I
Get a run's debug bundle
curl --request GET \
--url https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle', 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.forge.gloo.com/api/v3/runs/{runId}/debug-bundle",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.forge.gloo.com/api/v3/runs/{runId}/debug-bundle")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"tier": "inline",
"schemaVersion": 1,
"capturedAt": 123,
"approximateSizeBytes": 1,
"bundle": {
"run": {
"id": "<string>",
"runType": "<string>",
"status": "<string>",
"interfaceId": "<string>",
"workflowId": "<string>",
"workflowVersion": 123,
"goal": "<string>",
"delegatedAgentId": "<string>",
"guardrails": "<unknown>",
"guardrailState": "<unknown>",
"args": "<unknown>",
"startedAt": 123,
"completedAt": 123,
"error": "<string>",
"totalTokens": 123,
"totalCost": 123,
"parentRunId": "<string>",
"parentStepId": "<string>",
"handlingSummary": {
"disposition": "normal",
"expectedExceptionNodeIds": [
"<string>"
],
"handledFailureNodeIds": [
"<string>"
],
"unresolvedFailureNodeIds": [
"<string>"
]
},
"executionOutcome": {
"schemaVersion": 1,
"classifierRevision": 1,
"source": "native",
"attempt": 123,
"workflowInstanceId": "<string>",
"statusAtCapture": "completed",
"coverage": "complete",
"reasonCodes": [
"not_recorded"
],
"selectedPaths": [
{
"nodeId": "<string>",
"nodeName": "<string>",
"labels": [
"<string>"
]
}
],
"omittedPathCount": 1,
"capturedAt": 123,
"summary": {
"disposition": "normal",
"expectedExceptionNodeIds": [
"<string>"
],
"handledFailureNodeIds": [
"<string>"
],
"unresolvedFailureNodeIds": [
"<string>"
]
},
"graphDigest": "<string>"
},
"executionOutcomeReadReason": "not_recorded"
},
"provenance": {
"runId": "<string>",
"kind": "production",
"workflowId": "<string>",
"workflow": {
"id": "<string>",
"name": "<string>"
},
"version": {
"id": "<string>",
"number": 123,
"status": "active",
"publishedAt": 123
},
"draft": {
"id": "<string>",
"baseVersionId": "<string>"
},
"currentAttempt": 2,
"attempts": [
2
]
},
"steps": [
{
"stepId": "<string>",
"nodeId": "<string>",
"status": "pending",
"kind": "procedure",
"agent": "<string>",
"model": "<string>",
"startedAt": 123,
"completedAt": 123,
"totalTokens": 123,
"cost": 123,
"hold": {
"state": "waiting",
"heldAt": 123,
"resolvedAt": 123,
"approvalId": "<string>",
"handoff": {
"kind": "console",
"decidedBy": "person",
"item": "<string>",
"path": "<string>",
"url": "<string>"
}
},
"outputs": "<unknown>",
"stdout": "<string>",
"error": {
"message": "<string>",
"code": "<string>",
"phase": "<string>",
"retryable": true,
"correlationId": "<string>"
},
"deliveryProgress": {
"confirmation": "queued",
"quorum": "all",
"state": "pending",
"startedAt": 123,
"deadlineAt": 123,
"required": 123,
"confirmed": 123,
"skipped": 123,
"unresolved": 123,
"safeNextAction": "wait"
}
}
],
"validatorRuns": [
{
"id": "<string>",
"attempt": 123,
"kind": "schema",
"verdict": "pass",
"feedback": "<string>",
"schemaSnapshot": "<unknown>",
"receivedOutputs": "<unknown>",
"startedAt": 123,
"completedAt": 123
}
],
"graph": {
"versionId": "<string>",
"draftId": "<string>",
"nodes": [
{
"id": "<string>",
"name": "<string>",
"type": "<string>"
}
]
}
}
},
"meta": {
"requestId": "<string>",
"partial": true,
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "bad_request",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "forbidden",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "resource_missing",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "internal_error",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}
