Skip to main content
GET
Get a canonical durable run

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

run_id
string
required
Minimum string length: 1

Response

200 - application/json

Run summary

run_id
string
required
Minimum string length: 1
kind
enum<string>
required
Available options:
agent,
workflow,
task,
eval
status
enum<string>
required
Available options:
pending,
running,
waiting,
completed,
failed,
cancelled
owner
object
required
conversation_id
string<uuid> | null
required
message_id
string<uuid> | null
required
usage
object | null
required
parent_run_id
string | null
required
Minimum string length: 1
root_run_id
string
required
Minimum string length: 1
waiting_reason
enum<string> | null
required
Available options:
tool,
approval,
event,
input
target
string | null
required
workflow_id
string | null
required
schedule_id
string<uuid> | null
required
batch_id
string<uuid> | null
required
runtime_target_kind
enum<string> | null
required

Provide the runtime target kind.

Available options:
main_branch,
environment,
preview_branch
runtime_target_environment_id
string<uuid> | null
required
runtime_target_branch_id
string<uuid> | null
required
error
object | null
required
logs
string | null
required
artifacts
null[]
required
duration_ms
integer | null
required
exit_code
integer | null
required
start_mode
string | null
required
timeout_seconds
integer | null
required
backoff_limit
integer | null
required
trigger_kind
enum<string> | null
required
Available options:
manual,
schedule,
webhook,
api
trigger_id
string | null
required
created_by
string | null
required
Required string length: 1 - 255
updated_at
string
required
created_at
string
required
started_at
string | null
required
completed_at
string | null
required
metadata
unknown
input
unknown
config
unknown
output
unknown