Skip to main content
POST
/
v1
/
runs
/
{runId}
/
feedback
Refine Run with Feedback
curl --request POST \
  --url https://app.uselamina.ai/v1/runs/{runId}/feedback \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "feedback": "Make the background brighter and increase contrast on the product"
}
'
{
  "data": {
    "runId": "99ebc7c6-24f3-4fc2-9d53-2e3f49f3bec1",
    "status": "completed",
    "summary": "Brightened the background and increased product contrast",
    "refinedNodes": [
      {
        "nodeId": "designer-a",
        "reason": "Background brightness and contrast adjustment"
      }
    ],
    "outputs": [
      {
        "id": "designer-a",
        "label": "Product Hero",
        "type": "image",
        "value": "https://cdn.uselamina.ai/outputs/refined-hero.png"
      }
    ],
    "errorMessage": null
  }
}
Iterative refinement for completed runs. Provide natural-language feedback and the engine re-executes only the nodes that need to change. The feedback agent uses an LLM to analyze which workflow nodes (image generation, video editing, etc.) need prompt modifications to address the feedback, rewrites only those prompts, and re-executes the affected subgraph. Use this for quality feedback loops: generate content, review it, then refine without starting over.

Authorizations

x-api-key
string
header
required

Workspace API key. Prefix: lma_. Example: lma_abc123...

Path Parameters

runId
string<uuid>
required

The run to refine.

Body

application/json
feedback
string
required

Natural-language feedback describing what to change in the outputs.

Response

Refinement result with updated outputs

data
object