---
title: "Edit your image title, description, and visibility"
method: PUT
path: "/api/profile/images/{id}"
---

# Edit your image title, description, and visibility

`PUT /api/profile/images/{id}`

## Request

- Base URL: `https://api.peelaway.io`
- URL: `https://api.peelaway.io/api/profile/images/{id}`
- Auth: API key in cookie `better-auth.session_token`

Owner browser session only. Title and description may be cleared with empty strings. Optional visibility (private or public) is saved atomically with the details; omitting it preserves current visibility. Publishing requires verified email or billing and a finished output. Up to 60 detail updates per hour, with visibility submissions sharing the 30-per-hour publication limit.

## Request body

- object
  - `title` string, required
  - `description` string, required
  - `visibility` 'private' | 'public'

## Response `200`

Saved title, description, and visibility

## Other responses

- `400`: Invalid fields
- `401`: Sign in required
- `403`: Browser session required
- `404`: Image not owned or not finished
- `429`: Too many updates

---

[API](https://skmtc.dev/peelaway/apis/peelaway-image-api.md) · [All operations](https://skmtc.dev/peelaway/apis/peelaway-image-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peelaway/apis/peelaway-image-api/revisions/8ce45533c9d0?raw)