> ## Documentation Index
> Fetch the complete documentation index at: https://docs.makelocalads.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit an idea's direction

> Change what a listing image slot will be rendered from.

[← Listing images](/listing-images/overview)

**Endpoint:** `PATCH https://makelocalads.com/api/v1/amazon-listing-ideas/{idea_id}`
**Permission:** `amazon_listings:update`

Each idea slot has a `summary`: the direction its image is rendered from.
Replace it when you want a different shot. The new direction is used the next
time the slot is rendered. It is free.

## Quick start

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request PATCH \
  --url https://makelocalads.com/api/v1/amazon-listing-ideas/4d6f8a1c-3e5b-4c7d-9f1a-2b4c6d8e0f1a \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "summary": "The throw folded on an oak bench, morning light, no props." }'
```

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "4d6f8a1c-3e5b-4c7d-9f1a-2b4c6d8e0f1a",
  "product_id": "a1516a75-9be5-461a-93af-c1896a0a3127",
  "marketplace": "us",
  "position": 0,
  "slot_type": "main",
  "title": "MAIN IMG",
  "summary": "The throw folded on an oak bench, morning light, no props.",
  "creative_id": null,
  "status": "idea",
  "image_url": null,
  "updated_at": "2026-09-25T10:05:00.000Z"
}
```

## Input fields

<ParamField body="summary" type="string" required>
  The direction the slot's image is rendered from, 1 to 2,000 characters.
</ParamField>

<Accordion title="Complete JSON schema">
  ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "type": "object",
    "additionalProperties": false,
    "required": ["summary"],
    "properties": {
      "summary": { "type": "string", "minLength": 1, "maxLength": 2000 }
    }
  }
  ```
</Accordion>

## Errors

| Status | Code | Meaning |
| - | - | - |
| `404` | `idea_not_found` | The idea is not available to you |

See [Errors and retries](/concepts/errors) for the error format.
