---
title: "List technique run history"
method: GET
path: "/technique-runs"
tags: ["Technique Runs"]
---

# List technique run history

`GET /technique-runs`

## Request

- Base URL: `https://app.flora.ai/api/v1`
- URL: `https://app.flora.ai/api/v1/technique-runs`
- Auth: HTTP bearer

Lists technique run history for the authenticated caller, including pending, running, completed, and failed technique runs. Results are newest first and can be filtered by workspace_id, project_id, technique_id, and status. Each item includes poll_url; use it to poll pending/running technique runs and to fetch completed or failed run details and outputs.

## Query parameters

- `limit` integer: Maximum number of results to return
- `cursor` string: Opaque cursor for fetching the next page
- `workspace_id` string: Workspace identifier
- `project_id` string: Project identifier
- `status` 'pending' | 'running' | 'completed' | 'failed': Run status filter
- `technique_id` string: Technique identifier

## Response `200`

Technique run history returned.

- object
  - `technique_runs` object[], required
    - `run_id` string, required: Run identifier
    - `status` 'pending' | 'running' | 'completed' | 'failed', required
    - `progress` number, required
    - `created_at` number, required
    - `started_at` number
    - `completed_at` number
    - `error_code` string: Machine-readable run error code
    - `error_message` string: Human-readable run error message
    - `charged_cost` number: Cost charged in USD
    - `outputs` object[]
      - `output_id` string, required: Run output identifier
      - `type` 'imageUrl' | 'videoUrl' | 'audioUrl' | 'text' | 'documentUrl' | 'model3dUrl', required: Run output media type
      - `url` string, required: Run output URL or text content
      - `asset_id` string: Asset identifier for durable media outputs
      - `label` string: Optional output label
      - `tri_count` integer: Triangle count for model3d outputs
      - `bbox` object: Axis-aligned local bounds for model3d outputs
        - `min` unknown[], required
          - unknown
        - `max` unknown[], required
          - unknown
      - `textured` boolean: Whether the model3d output carries textures
    - `poll_url` string, uri: URL to poll pending/running runs or fetch completed/failed run details.
    - `technique_run_id` string, required: Run identifier
    - `workspace_id` string, required: Workspace identifier
    - `project_id` string, required: Project identifier
    - `technique` object, required
      - `technique_id` string, required: Technique identifier
      - `name` string, required: Technique name
  - `meta` object, required
    - `next_cursor` string, nullable, required: Opaque cursor for fetching the next page
    - `total_estimate` integer, nullable: Estimated total matching items

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `403`: 403
- `404`: 404
- `409`: 409
- `429`: 429
- `500`: 500
- `503`: 503

## Changes

- **2026-10-28** `a8351619f225`: 9 warning
  - added the new `not_configured` enum value to the `error/code` response property for the response status `400`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `401`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `402`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `403`
  - …5 more
- **2026-10-16** `e54130373b10`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/changes/technique-runs/get.md)

---

[API](https://skmtc.dev/florafauna-ai/apis/flora-ai-api.md) - [All operations](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/revisions/87cfe2c4ac29?raw)