FLflorafauna-ai
Generations

List generation history

Changed on

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

get/generations

Request

  • Base URL
    https://app.flora.ai/api/v1
  • URL
    https://app.flora.ai/api/v1/generations
  • Auth
    HTTP bearer

Query parameters

limitinteger

Maximum number of results to return

cursorstring

Opaque cursor for fetching the next page

Example:eyJvZmZzZXQiOjIwfQ
workspace_idstring

Workspace identifier

Example:ws_abc123
project_idstring

Project identifier

Example:prj_abc123
status'pending' | 'running' | 'completed' | 'failed'

Run status filter

include_inputsboolean

Include each generation's submitted inputs (prompt and input references) on the item. Off by default; the inputs block can be large.

Example:true

Response

Generation history returned.

Example response

{
  "generations": [
    {
      "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"
        }
      ],
      "generation_id": "run_abc123",
      "workspace_id": "ws_abc123",
      "project_id": "prj_abc123",
      "model": {
        "model_id": "t2i-flux-2-pro"
      },
      "inputs": {
        "asset_ids": [
          "asset_abc123"
        ]
      }
    }
  ],
  "meta": {
    "next_cursor": "eyJvZmZzZXQiOjIwfQ"
  }
}

Changes

  • a8351619f225Revision 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

  • e54130373b10Revision changes
    • info

      endpoint added