Skip to content
FLORA FLORA API

Get a technique run

GET
/techniques/{techniqueId}/runs/{runId}
 
import { FloraClient } from '@flora-ai/flora';


const client = new FloraClient({ apiKey: process.env['FLORA_API_KEY'] });


const run = await client.techniques.runs.retrieve({
  techniqueId: '<techniqueId>',
  runId: '<runId>',
});
console.log(run);

Returns status, progress, outputs, and error details for a technique run when it is accessible to the authenticated public API key.

Error responses use the standard error body.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
techniqueId
required

Technique identifier or slug

string
>= 1 characters /^\S+$/

Technique identifier or slug

runId
required

Run identifier

string
/^run_\S+$/

Run identifier

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Technique run returned.

Media type application/json
object
run_id
required

Run identifier

string
/^run_\S+$/
status
required
string
Allowed values: pending running completed failed
progress
required
number
created_at
required
number
started_at
number
completed_at
number
error_code

Machine-readable run error code

string
error_message

Human-readable run error message

string
charged_cost

Cost charged in USD

number
outputs
Array<object>
object
output_id
required

Run output identifier

string
type
required

Run output media type

string
Allowed values: imageUrl videoUrl audioUrl text documentUrl model3dUrl
url
required

Run output URL or text content

string
>= 1 characters
asset_id

Asset identifier for durable media outputs

string
/^asset_\S+$/
label

Optional output label

string
tri_count

Triangle count for model3d outputs

integer
bbox

Axis-aligned local bounds for model3d outputs

object
min
required
array
max
required
array
textured

Whether the model3d output carries textures

boolean
poll_url

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

string format: uri
Example 
{
  "run_id": "run_abc123",
  "status": "pending",
  "error_code": "provider_error",
  "error_message": "The provider failed to complete the generation.",
  "outputs": [
    {
      "output_id": "output_1",
      "type": "imageUrl",
      "url": "https://media.flora.ai/output.png",
      "asset_id": "asset_abc123",
      "label": "preview"
    }
  ]
}