---
title: "convertImage"
method: POST
path: "/image/convert"
tags: ["image-conversion"]
---

# convertImage

`POST /image/convert`

Convert a given image to another format.

## Request body

- ImageBean
  - `buffer` string[]
  - `originalFormat` 'RAW' | 'RGB' | 'BMP' | 'BMP24BITS' | 'GIF' | 'JPEG' | 'JPEG2000' | 'PNG' | 'TIFF' | 'WSQ'
  - `toFormat` 'RAW' | 'RGB' | 'BMP' | 'BMP24BITS' | 'GIF' | 'JPEG' | 'JPEG2000' | 'PNG' | 'TIFF' | 'WSQ'
  - `resolution` integer — Resolution of the original image

## Response `200`

Convert image ok

- ImageResponse
  - `status` 'OK' | 'ERROR' | 'BAD_REQUEST' | 'CREATED' | 'NO_CONTENT' | 'DELETED' | 'CANCELLED' | 'CLOSED' | 'REMOVED' | 'NOT_FOUND' | 'AUTHENTICATION_FAILED' | 'AUTHENTICATION_OK' | 'INVALID_SESSION_GUID' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'RECEIVED' | 'ACCEPTED' | 'ENQUEUED' | 'INVALID_PARAMETERS' | 'FIELD_VALIDATION_ERROR' | 'ILLEGAL_STATE' | 'NOT_ENOUGH_DATA' | 'VALIDATION_ERROR' | 'IMPORTED' | 'UPDATED' | 'IGNORED' | 'SERVICE_STARTED' | 'SERVICE_CANCELLED' | 'SERVICE_SUBMITTED'
  - `code` integer
  - `image` ImageBean
    - `buffer` string[]
    - `originalFormat` 'RAW' | 'RGB' | 'BMP' | 'BMP24BITS' | 'GIF' | 'JPEG' | 'JPEG2000' | 'PNG' | 'TIFF' | 'WSQ'
    - `toFormat` 'RAW' | 'RGB' | 'BMP' | 'BMP24BITS' | 'GIF' | 'JPEG' | 'JPEG2000' | 'PNG' | 'TIFF' | 'WSQ'
    - `resolution` integer — Resolution of the original image

## Other responses

- `400` — Parameters validation error
- `403` — Access denied
- `500` — System error

---

[API](https://skmtc.net/griaule/apis/gbds-api.md) · [All operations](https://skmtc.net/griaule/apis/gbds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griaule/gbds-api/versions/fa80f482ec5e/schema)