Skip to main content
GET
Get a project-agent run

Authorizations

Authorization
string
header
required

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

Path Parameters

conversation_id
string<uuid>
required
run_id
string
required
Minimum string length: 1

Response

Agent run

run_id
string
required
Minimum string length: 1
conversation_id
string<uuid> | null
required
message_id
string<uuid> | null
required
project_id
string<uuid> | null
required
requested_by_user_id
string<uuid>
required
agent_id
string
required
Required string length: 1 - 128
status
required
Available options:
completed,
failed,
cancelled
runtime_target_kind
enum<string> | null
required

Provide the runtime target kind.

Available options:
main_branch,
environment,
preview_branch
latest_event_id
integer
required
Required range: x >= 0
created_at
string
required
run_snapshot
object
required
implementation_kind
string | null
Required string length: 1 - 64
worker_key
string | null
Required string length: 1 - 128
source_target_kind
enum<string> | null
Available options:
project,
main_branch,
environment,
preview_branch,
release
source_target_environment_id
string<uuid> | null
source_target_branch_id
string<uuid> | null
source_target_release_version
string | null
Required string length: 1 - 128
runtime_target_environment_id
string<uuid> | null
runtime_target_branch_id
string<uuid> | null
parent_conversation_id
string<uuid> | null
parent_run_id
string | null
Minimum string length: 1
spawned_from_message_id
string<uuid> | null
spawned_from_tool_call_id
string | null
Required string length: 1 - 128
input_anchor_message_id
string<uuid> | null
handoff_message_id
string<uuid> | null
resolved_deployment_id
string<uuid> | null
latest_external_event_sequence
integer
Required range: x >= 0
waiting_tool_call_id
string | null
Required string length: 1 - 128
waiting_tool_name
string | null
terminal_error_code
string | null
terminal_error_message
string | null
started_at
string | null
finished_at
string | null