Technique Runs

Start a technique run

Changed on Oct 28, 2026

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

Request

Base URL
https://app.flora.ai/api/v1
URL
https://app.flora.ai/api/v1/techniques/{techniqueId}/runs
Auth
HTTP bearer

Path parameters

techniqueIdstring required

Technique identifier or slug

Example:art-directors-critique

Request body

mode'async' | 'stream' required

Technique run execution mode

callback_urlstring uri

HTTPS URL that receives a signed POST webhook when the run reaches a terminal state (events run.completed / run.failed). The JSON body is HMAC-SHA256 signed via the Flora-Signature header and delivery is retried up to 3 times with exponential backoff. Must be HTTPS and must not resolve to a private/internal host. See https://docs.flora.ai/api/platform/webhooks for the payload schema and verification example.

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

URL to poll pending/running runs or fetch completed/failed run details.

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",
      "asset_id": "asset_abc123",
      "label": "preview"
    }
  ]
}

Changes

Oct 28, 2026a8351619f225 Revision changes
- warning
  added the new not_configured enum value to the / response property for the response status
- warning
  added the new not_configured enum value to the / response property for the response status
- warning
  added the new not_configured enum value to the / response property for the response status
- warning
  added the new not_configured enum value to the / response property for the response status
- warning
  added the new not_configured enum value to the / response property for the response status
- warning
  added the new not_configured enum value to the / response property for the response status
- warning
  added the new not_configured enum value to the / response property for the response status
- warning
  added the new not_configured enum value to the / response property for the response status
- warning
  added the new not_configured enum value to the / response property for the response status
Oct 16, 2026e54130373b10 Revision changes
- breaking
  the // response's property format changed from uri to no format for status
- breaking
  the // response's property format changed from uri to no format for status
- warning
  added the new model3dUrl enum value to the // response property for the response status
- warning
  added the new model3dUrl enum value to the // response property for the response status
- warning
  added the new paid_plan_required enum value to the / response property for the response status
- warning
  added the new paid_plan_required enum value to the / response property for the response status
- warning
  added the new paid_plan_required enum value to the / response property for the response status
- warning
  added the new paid_plan_required enum value to the / response property for the response status
- warning
  added the new paid_plan_required enum value to the / response property for the response status
- warning
  added the new paid_plan_required enum value to the / response property for the response status
- warning
  added the new paid_plan_required enum value to the / response property for the response status
- warning
  added the new paid_plan_required enum value to the / response property for the response status
- warning
  added the new revision_conflict enum value to the / response property for the response status
- warning
  added the new revision_conflict enum value to the / response property for the response status
- warning
  added the new revision_conflict enum value to the / response property for the response status
- warning
  added the new revision_conflict enum value to the / response property for the response status
- warning
  added the new revision_conflict enum value to the / response property for the response status
- warning
  added the new revision_conflict enum value to the / response property for the response status
- warning
  added the new revision_conflict enum value to the / response property for the response status
- warning
  added the new revision_conflict enum value to the / response property for the response status
- warning
  added the new temporarily_unavailable enum value to the / response property for the response status
- warning
  added the new temporarily_unavailable enum value to the / response property for the response status
- warning
  added the new temporarily_unavailable enum value to the / response property for the response status
- warning
  added the new temporarily_unavailable enum value to the / response property for the response status
- warning
  added the new temporarily_unavailable enum value to the / response property for the response status
- warning
  added the new temporarily_unavailable enum value to the / response property for the response status
- warning
  added the new temporarily_unavailable enum value to the / response property for the response status
- warning
  added the new temporarily_unavailable enum value to the / response property for the response status
- info
  added the new model3dUrl enum value to the request property //
- info
  added the non-success response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status

Operation history (7 revisions)