Runs

Run an app

Start a new run of an app with the given inputs. Returns immediately with run ID; poll GET /runs/{id} or use SSE streaming for results.

post/apps/{appId}/runs

Request

  • Base URL: https://app.uselamina.ai/v1
  • URL: https://app.uselamina.ai/v1/apps/{appId}/runs
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

appIdstring uuid required

Query parameters

webhookstring uri

Webhook URL for completion callback

Request body

inputsobject

Input values keyed by parameter name or ID

inputOverridesobject

Per-node input overrides

applyBrandboolean

Fold the workspace's brand (negatives + visual style) onto the app's visual generation nodes so output is on-brand, without hand-writing brand into inputs. Layered below your inputs, which always win.

brandProfileIdstring

Target a specific brand profile when applyBrand is set. Omit to use the workspace active brand.

testboolean

Sandbox mode (or send header X-Lamina-Test: true): validate inputs and return a deterministic stub run — no execution is dispatched and no credits are charged.

Response

Execution started

Changes

No recorded changes to this operation across all 1 revision of this API.