curl --request GET \
--url https://api.veryfront.com/runs/{run_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.veryfront.com/runs/{run_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.veryfront.com/runs/{run_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://api.veryfront.com/runs/{run_id}",
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.veryfront.com/runs/{run_id}"
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.veryfront.com/runs/{run_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.veryfront.com/runs/{run_id}")
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{
"id": "11111111-1111-4111-8111-111111111111",
"run_id": "11111111-1111-4111-8111-111111111111",
"status": "completed",
"project_id": "00000000-0000-4000-8000-000000000001",
"target": {
"type": "task",
"id": "summarize"
},
"input": {
"text": "A short document."
},
"output": {
"summary": "A short summary."
},
"title": "Summarize text",
"created_at": "2026-10-02T10:00:00Z",
"updated_at": "2026-10-02T10:00:02Z",
"trigger": {
"type": "api_key",
"id": "key_example"
},
"started_at": "2026-10-02T10:00:00Z",
"finished_at": "2026-10-02T10:00:02Z"
}Get run
Get run details: status, errors, target, timing, token usage and cost, by run UUID or public id.
curl --request GET \
--url https://api.veryfront.com/runs/{run_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.veryfront.com/runs/{run_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.veryfront.com/runs/{run_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://api.veryfront.com/runs/{run_id}",
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.veryfront.com/runs/{run_id}"
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.veryfront.com/runs/{run_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.veryfront.com/runs/{run_id}")
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{
"id": "11111111-1111-4111-8111-111111111111",
"run_id": "11111111-1111-4111-8111-111111111111",
"status": "completed",
"project_id": "00000000-0000-4000-8000-000000000001",
"target": {
"type": "task",
"id": "summarize"
},
"input": {
"text": "A short document."
},
"output": {
"summary": "A short summary."
},
"title": "Summarize text",
"created_at": "2026-10-02T10:00:00Z",
"updated_at": "2026-10-02T10:00:02Z",
"trigger": {
"type": "api_key",
"id": "key_example"
},
"started_at": "2026-10-02T10:00:00Z",
"finished_at": "2026-10-02T10:00:02Z"
}Authorizations
Use a JWT bearer token or a Veryfront API key in the Authorization header.
Path Parameters
Run UUID, or any public run id (run_… or an older id) as legacy run reads, run events and usage records carry it. The response id is the run UUID that every other run operation takes.
1 - 128^[a-zA-Z0-9_-]+$Response
Read a run by its UUID or public run id (run_…), including its labels and grouped execution, control, usage and schema metadata. The returned ETag guards metadata updates.
One execution resource returned by reads, creation, updates, and lifecycle actions. Omit irrelevant fields and empty groups. Errors appear only on failure; parent/root IDs only on child runs; timestamps appear when reached. Output is null until successful finalization.
Unique run UUID.
Public run ID that run events (metadata.run_id) and runtime tools name. Equals id for runs the server names; older runs keep their run_ ID.
1Current execution state.
pending, running, waiting, completed, failed, cancelled Project containing the run.
Execution definition; its ID may be null only on historical runs.
Show child attributes
Show child attributes
Business input supplied when the run was created.
Final business output; null until successful finalization.
When the run was accepted.
When the resource last changed, including usage updates.
Failure details, present only when the run failed.
Show child attributes
Show child attributes
Display title, omitted when unset.
Labels used to organize runs.
Show child attributes
Show child attributes
Immediate parent run ID, present on child runs.
Top-level ancestor run ID, present on child runs.
When the first execution attempt started, omitted before execution.
When the run completed, failed or was cancelled.
Definition-specific execution configuration.
Show child attributes
Show child attributes
Resolved execution settings and diagnostics.
Show child attributes
Show child attributes
Pending control requests and the current wait.
Show child attributes
Show child attributes
Orchestration task ID, distinct from the execution definition.
1 - 200Conversation containing the run.
Conversation message that supplied the input.
Conversation message containing the result.
Batch containing the run.
How execution was initiated.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
Show child attributes
Show child attributes
Usage when available; unknown measurements are null.
Show child attributes
Show child attributes
Counts and usage across all descendant runs, excluding this run.
Show child attributes
Show child attributes
Files produced by the run.
Show child attributes
Show child attributes
Pinned schemas for business input and output; null means no declared schema.
Show child attributes
Show child attributes
Additional resource metadata.
Show child attributes
Show child attributes