curl --request POST \
  --url https://api.varg.ai/v2/jobs/{id}/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "approve"
}
'

{
  "id": "job_a1b2c3d4e5f6",
  "status": "queued",
  "stage": "queued",
  "attempts": [
    {
      "n": 1,
      "provider": "byteplus",
      "model_key": "byteplus:dreamina-seedance-2-5-260628",
      "status": "running",
      "reason": "real person in the reference images",
      "reason_code": "content_privacy",
      "references_uploaded": 123,
      "resubmitted": true,
      "started_at": "2023-11-07T05:31:56Z",
      "ended_at": "2023-11-07T05:31:56Z"
    }
  ],
  "tool": "tool_2001a2b3c4d5",
  "input": {},
  "output": {
    "version": "v1",
    "outputs": [
      {
        "url": "<string>",
        "file_id": "<string>",
        "media_type": "video/mp4",
        "size_bytes": 123,
        "thumbnail_url": "<string>",
        "data": "<unknown>",
        "raw": "<unknown>"
      }
    ]
  },
  "error": "<string>",
  "progress_message": "stitching 3/8 (40%)",
  "progress": 123,
  "progress_metadata": {},
  "step_state": {
    "current_step": "extend",
    "steps": {}
  },
  "estimated_duration_ms": 123,
  "estimated_cost_cents": 123,
  "actual_cost_cents": 123,
  "pricing": {
    "estimated": 123,
    "actual": 123,
    "billing": "<string>",
    "cached": true,
    "billed_units": {
      "images": 1
    },
    "pricing_id": "<string>"
  },
  "provider": "fal",
  "provider_model": "fal:flux_schnell",
  "provider_status": "<string>",
  "provider_job_id": "<string>",
  "completed_by_provider_model_id": "<string>",
  "last_attempt_provider_model_id": "<string>",
  "workspace_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "warnings": [
    "<string>"
  ],
  "urls": {
    "self": "<string>",
    "status": "<string>",
    "refresh": "<string>",
    "cancel": "<string>",
    "retry": "<string>",
    "confirm": "<string>",
    "rerun": "<string>"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key or JWT"
  }
}

{
  "error": {
    "code": "insufficient_balance",
    "message": "Needs 40 credits; 25 available right now (60 on hold for 2 running jobs)",
    "details": {
      "needed_cents": 40,
      "available_cents": 25,
      "reserved_cents": 60,
      "total_cents": 85,
      "held_jobs": 2,
      "job_id": "job_a1b2c3d4e5f6"
    }
  }
}

{
  "error": {
    "code": "model_not_found",
    "message": "Unknown model: flux-shnell",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "conflict",
    "message": "Job is not awaiting_confirmation (status: running)"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Body validation failed (text: Required)"
  }
}

Jobs

Approve, retry or reject a paused job

Resumes or ends a multi-step pipeline job that is paused in awaiting_confirmation after a step that asked for confirmation. The job’s step_state shows each step’s status and intermediate output.

approve (default) runs the next step.
retry runs the same step again (a new take). Use overrides to change the input, for example an edited prompt.
reject cancels the job. Steps already completed stay billed.

The steps completed so far are billed when the job pauses and the hold is released, so approve and retry reserve the estimate for the remaining steps again. If the balance does not cover it, the response is 402 insufficient_balance and the job stays paused: add credits and confirm again. The response is the job, now queued (approve/retry) or cancelled (reject).

POST

jobs

{id}

confirm

curl --request POST \
  --url https://api.varg.ai/v2/jobs/{id}/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "approve"
}
'

{
  "id": "job_a1b2c3d4e5f6",
  "status": "queued",
  "stage": "queued",
  "attempts": [
    {
      "n": 1,
      "provider": "byteplus",
      "model_key": "byteplus:dreamina-seedance-2-5-260628",
      "status": "running",
      "reason": "real person in the reference images",
      "reason_code": "content_privacy",
      "references_uploaded": 123,
      "resubmitted": true,
      "started_at": "2023-11-07T05:31:56Z",
      "ended_at": "2023-11-07T05:31:56Z"
    }
  ],
  "tool": "tool_2001a2b3c4d5",
  "input": {},
  "output": {
    "version": "v1",
    "outputs": [
      {
        "url": "<string>",
        "file_id": "<string>",
        "media_type": "video/mp4",
        "size_bytes": 123,
        "thumbnail_url": "<string>",
        "data": "<unknown>",
        "raw": "<unknown>"
      }
    ]
  },
  "error": "<string>",
  "progress_message": "stitching 3/8 (40%)",
  "progress": 123,
  "progress_metadata": {},
  "step_state": {
    "current_step": "extend",
    "steps": {}
  },
  "estimated_duration_ms": 123,
  "estimated_cost_cents": 123,
  "actual_cost_cents": 123,
  "pricing": {
    "estimated": 123,
    "actual": 123,
    "billing": "<string>",
    "cached": true,
    "billed_units": {
      "images": 1
    },
    "pricing_id": "<string>"
  },
  "provider": "fal",
  "provider_model": "fal:flux_schnell",
  "provider_status": "<string>",
  "provider_job_id": "<string>",
  "completed_by_provider_model_id": "<string>",
  "last_attempt_provider_model_id": "<string>",
  "workspace_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "warnings": [
    "<string>"
  ],
  "urls": {
    "self": "<string>",
    "status": "<string>",
    "refresh": "<string>",
    "cancel": "<string>",
    "retry": "<string>",
    "confirm": "<string>",
    "rerun": "<string>"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key or JWT"
  }
}

{
  "error": {
    "code": "insufficient_balance",
    "message": "Needs 40 credits; 25 available right now (60 on hold for 2 running jobs)",
    "details": {
      "needed_cents": 40,
      "available_cents": 25,
      "reserved_cents": 60,
      "total_cents": 85,
      "held_jobs": 2,
      "job_id": "job_a1b2c3d4e5f6"
    }
  }
}

{
  "error": {
    "code": "model_not_found",
    "message": "Unknown model: flux-shnell",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "conflict",
    "message": "Job is not awaiting_confirmation (status: running)"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Body validation failed (text: Required)"
  }
}

Authorizations

Authorization

string

header

required

varg API key (varg_...). Get one at app.varg.ai or run bunx vargai login. App sessions may alternatively send a Supabase JWT.

Path Parameters

string

required

Pattern: ^job_

Body

application/json

action

enum<string>

default:approve

approve runs the next step, retry runs the same step again, reject cancels the job.

Available options:

approve,

retry,

reject

overrides

object

Input fields to change for the resumed step, for example an edited prompt. They are also kept for later steps.

Response

The job after the decision

string

required

Example:

"job_a1b2c3d4e5f6"

status

enum<string>

required

The status only moves forward: queued → running → completed, failed or cancelled. Everything a running job goes through — sending to the provider, uploading references, switching to another provider — is a stage of running; a job never goes back to queued. (Older API builds also reported submitting; treat it as running.)

awaiting_confirmation (multi-step pipelines only): the job finished a step that asks for review and waits for POST /jobs/{id}/confirm. It is not terminal.

Available options:

queued,

running,

awaiting_confirmation,

completed,

failed,

cancelled

stage

enum<string> | null

required

What the job is doing right now. null once the job is terminal, and while the job is awaiting_confirmation.

queued — waiting for a slot; no attempt yet
submitting — being sent to the provider
uploading_references — the provider is taking the reference files into its asset library (progress_message shows n/m)
rendering — the provider accepted the task and is generating
retrying — an attempt failed (the provider refused, failed or rate limited it); the job waits for its next attempt, usually on another provider. See attempts.
finalizing — the result is being saved and billed

Available options:

queued,

submitting,

uploading_references,

rendering,

retrying,

finalizing,

null

attempts

object[]

required

Every provider tried for this job, oldest first. provider / provider_model are the newest one.

Show child attributes

tool

string

required

Internal tool id (e.g. tool_2001a2b3c4d5 for video), not the tool_key. Do not compare it against GET /tools keys.

Example:

"tool_2001a2b3c4d5"

input

object

required

The request body as submitted (model, prompt, ...)

output

object | null

required

Canonical output envelope. Present only when the job is completed.

Show child attributes

error

string | null

required

Human-readable failure message. null unless the job failed or was cancelled.

progress_message

string | null

required

Example:

"stitching 3/8 (40%)"

progress

number | null

required

Fraction 0..1

progress_metadata

object | null

required

step_state

object | null

required

Multi-step pipeline jobs only: the current step and each step's status, intermediate output and cost. null for ordinary jobs.

Show child attributes

estimated_duration_ms

integer | null

required

estimated_cost_cents

integer | null

required

actual_cost_cents

integer | null

required

pricing

object

required

Structured pricing. 1 credit = 1 cent = $0.01.

Show child attributes

provider

string | null

required

Example:

"fal"

provider_model

string | null

required

Example:

"fal:flux_schnell"

provider_status

string | null

required

The provider's raw status string

provider_job_id

string | null

required

completed_by_provider_model_id

string | null

required

Provider model route that completed the job

last_attempt_provider_model_id

string | null

required

Provider model route of the most recent attempt

workspace_id

string | null

required

Folder the outputs are filed into (see X-Workspace-Id)

created_at

string<date-time>

required

started_at

string<date-time> | null

required

completed_at

string<date-time> | null

required

warnings

string[]

Present on creation responses when the request was adjusted (for example a resolution fallback)

urls

object

Lifecycle URLs (present on creation responses)

Show child attributes

Overview

Presets

Generation

Tools

Jobs

Files

Folders

Templates

Pricing & Billing

Analytics

Account

Approve, retry or reject a paused job

Authorizations

Path Parameters

Body

Response