Sign in

v8

latestOpenAPI 3.1.1LicenseRef-Proprietaryraw.githubusercontent.com2026-05-19280916.6 KB
Technique Runs

Start a technique run

Starts a run for a specific technique using the backward-compatible nested route. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.

post/techniques/{techniqueId}/runs

Path parameters

techniqueIdstring required

Technique identifier or slug

Example:art-directors-critique

Technique identifier or slug

Request body

mode'async' | 'stream' required

Technique run execution mode

callback_urlstring uri

HTTPS callback URL for asynchronous run completion notifications

idempotency_keystring

Idempotency key for safely retrying requests

Response

Technique run started.

run_idstring required

Run identifier

status'pending' | 'running' | 'completed' | 'failed' required
progressnumber required
created_atnumber required
started_atnumber
completed_atnumber
error_codestring

Machine-readable run error code

error_messagestring

Human-readable run error message

charged_costnumber

Cost charged in USD

poll_urlstring uri

Example response

{
  "run_id": "run_abc123",
  "error_code": "provider_error",
  "error_message": "The provider failed to complete the generation.",
  "outputs": [
    {
      "output_id": "output_1",
      "url": "https://media.flora.ai/output.png"
    }
  ]
}