---
title: "Edit Image"
method: POST
path: "/v1/teams/{team_id}/artifacts/edit-image"
tags: ["artifacts"]
---

# Edit Image

`POST /v1/teams/{team_id}/artifacts/edit-image`

## Request

- Base URL: `https://api.stormy.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stormy.ai/v1/teams/{team_id}/artifacts/edit-image`
- Auth: none declared

Transform stored image(s) by a prompt into a NEW artifact.

The source is never touched — artifacts are immutable, and an edit that
overwrote its original would destroy the evidence it was derived from.
The new row records what it came from, so the chain stays readable.

## Path parameters

- `team_id` string, uuid, required

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable
- `x-darwin-run-id` string, nullable

## Request body

- EditImageRequest
  - `prompt` string, required
  - `source_artifact_ids` string[], required
  - `title` string, nullable
  - `aspect_ratio` string, nullable
  - `quality` string, nullable
  - `input_fidelity` string, nullable
  - `kind` string
  - `work_item_id` string, uuid, nullable
  - `source_execution_type` string, nullable
  - `source_execution_id` string, uuid, nullable
  - `metadata` object
  - `idempotency_key` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/a40e83844eaa?raw)