Skip to main content
POST
/
runs
/
{run_id}
/
complete
Complete a canonical run
curl --request POST \
  --url https://api.veryfront.com/runs/{run_id}/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "completed",
  "metadata": {
    "provider": "<string>",
    "model": "<string>",
    "inputTokens": 123,
    "outputTokens": 123,
    "finishReason": "<string>",
    "cachedInputTokens": 123,
    "reasoningTokens": 123,
    "providerRequestId": "<string>"
  },
  "terminal_error_code": "<string>",
  "terminal_error_message": "<string>"
}
'
{
  "completed": true,
  "run": {
    "run_id": "<string>",
    "kind": "agent",
    "status": "pending",
    "owner": {
      "kind": "conversation",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "parent_run_id": "<string>",
    "root_run_id": "<string>",
    "waiting_reason": "tool",
    "created_at": "<string>",
    "started_at": "<string>",
    "completed_at": "<string>",
    "metadata": null
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

run_id
string
required
Minimum string length: 1

Body

application/json
status
enum<string>
required
Available options:
completed,
failed,
cancelled
metadata
object
terminal_error_code
string | null
terminal_error_message
string | null

Response

Run completed

completed
boolean
required
run
object
required