Skip to main content
GET
/
conversations
/
{conversation_id}
/
runs
/
{run_id}
Get a project-agent run
curl --request GET \
  --url https://api.veryfront.com/conversations/{conversation_id}/runs/{run_id} \
  --header 'Authorization: Bearer <token>'
{
  "run_id": "<string>",
  "conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requested_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agent_id": "<string>",
  "latest_event_id": 1,
  "created_at": "<string>",
  "run_snapshot": {
    "project_agent": {
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "<string>"
    },
    "source": {
      "path": "<string>",
      "hash": "<string>",
      "catalog_entry_id": "<string>"
    },
    "runtime_target": {
      "environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "branch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "resolved_target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "resolved_target_kind": "<string>",
      "deployment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "requester": {
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  },
  "implementation_kind": "<string>",
  "worker_key": "<string>",
  "source_target_environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source_target_branch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source_target_release_version": "<string>",
  "runtime_target_environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "runtime_target_branch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "parent_conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "parent_run_id": "<string>",
  "spawned_from_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "spawned_from_tool_call_id": "<string>",
  "input_anchor_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "handoff_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resolved_deployment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "latest_external_event_sequence": 1,
  "waiting_tool_call_id": "<string>",
  "waiting_tool_name": "<string>",
  "terminal_error_code": "<string>",
  "terminal_error_message": "<string>",
  "started_at": "<string>",
  "finished_at": "<string>"
}

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