**Version: 202601**

# Create product image

**POST** `/openapi/2026-01/products/:product_id/images`

Create a new product image with the provided details.

## Request

**Path Parameters**

- `product_id` string (required)

  The unique identifier for the product

**application/json**

**Body | Example**

**Body (required)**

- `image` object (required)

  Image

  - `src` string (required)

    The URL of the image. Must be a valid URL
  - `alt` string

    Alternative text for the image (used for accessibility or descriptions)
  - `width` int32

    The width of the image in pixels. Must be greater than 0
  - `height` int32

    The height of the image in pixels. Must be greater than 0
  - `position` int32

    The position of the image relative to other images. Must be greater than 0

```json
{
  "image": {
    "src": "string",
    "alt": "string",
    "width": 0,
    "height": 0,
    "position": 0
  }
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `image` object

    Image

    - `id` string

      The unique identifier for the image
    - `product_id` string

      The unique identifier for the product associated with the image
    - `position` int32

      The position of the image relative to other images in the product gallery
    - `src` string

      The URL of the image
    - `width` int32

      The width of the image in pixels
    - `height` int32

      The height of the image in pixels
    - `alt` string

      Alternative text for the image (used for accessibility or descriptions)
    - `created_at` string

      Image creation time
    - `updated_at` string

      Image last updated time

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "image": {
      "id": "string",
      "product_id": "string",
      "position": 0,
      "src": "string",
      "width": 0,
      "height": 0,
      "alt": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```