---
title: "Add Image"
method: POST
path: "/v1/projects/{projectId}/images"
tags: ["Project Editing"]
---

# Add Image

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

Add an image to a project by URL. Requires project:write permission.

## Path parameters

- `projectId` string, required

## Request body

- AddImageRequest
  - `url` string, uri, required — URL of the image
  - `description` string — Optional description. If omitted, an AI-generated description is filled in asynchronously after upload.
  - `tags` string[] — Optional tags. If omitted, AI-generated tags are filled in asynchronously after upload.

## Response `200`

Image added

- 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)