Skip to main content
POST
/
runs
Create a canonical durable run
curl --request POST \
  --url https://api.veryfront.com/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "owner": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "request": {
    "agent_id": "<string>",
    "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"
  },
  "public_id": "<string>",
  "parent_run_id": "<string>",
  "trigger": {
    "conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "tool_call_id": "<string>"
  },
  "conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "accepted": true,
  "run": {
    "run_id": "<string>",
    "owner": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "parent_run_id": "<string>",
    "root_run_id": "<string>",
    "target": "<string>",
    "workflow_id": "<string>",
    "schedule_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "runtime_target_environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "runtime_target_branch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "error": {
      "message": "<string>",
      "code": "<string>"
    },
    "logs": "<string>",
    "artifacts": [
      null
    ],
    "duration_ms": 123,
    "exit_code": 123,
    "start_mode": "<string>",
    "timeout_seconds": 123,
    "backoff_limit": 123,
    "trigger_id": "<string>",
    "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "updated_at": "<string>",
    "created_at": "<string>",
    "started_at": "<string>",
    "completed_at": "<string>",
    "metadata": null,
    "input": null,
    "config": null,
    "output": null
  },
  "duplicate": true,
  "conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
kind
enum<string>
required
Available options:
agent
​
owner
object
required
​
request
RuntimeAgentRequest · object
required
​
public_id
string
Required string length: 1 - 128
​
parent_run_id
string
Required string length: 1 - 128
​
trigger
object
​
conversation_mode
enum<string>
Available options:
create_new,
existing,
none
​
conversation_id
string<uuid>

Response

202 - application/json

Run accepted

​
accepted
boolean
required
​
run
object
required
​
duplicate
boolean
​
conversation_id
string<uuid> | null
​
message_id
string<uuid> | null