---
title: "Update Image Metadata"
method: PUT
path: "/v1/projects/{projectId}/images"
tags: ["Project Editing"]
---

# Update Image Metadata

`PUT /v1/projects/{projectId}/images`

Update image description and tags. Requires project:write permission.

## Path parameters

- `projectId` string, required

## Request body

- union — At least one of `description` or `tags` must be provided alongside `imageUrl`.
  - object
    - `imageUrl` string, uri, required — URL of the image to update
    - `description` string, required — Updated description
    - `tags` string[] — Updated tags
  - object
    - `imageUrl` string, uri, required — URL of the image to update
    - `description` string — Updated description
    - `tags` string[], required — Updated tags

## Response `200`

Image metadata updated

- object
  - `success` boolean, required
  - `data` object, nullable
    - `url` string, uri, required
    - `description` string
    - `tags` string[]
  - `error` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/2d06ad0e0bc3/schema)