---
title: "Convert HEIC images"
method: POST
path: "/v1/media/backfill-heic"
tags: ["media"]
---

# Convert HEIC images

`POST /v1/media/backfill-heic`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/media/backfill-heic`
- Auth: HTTP bearer

Convert this workspace's existing HEIC image assets to JPEG so they display correctly on devices that cannot decode HEIC. Safe to run more than once, and applies only to your own workspace. Returns a 503 error if the conversion feature is temporarily unavailable.

## Request body

- object
  - `limit` integer
  - `after` string: `nextAfter` of the previous run.

## Response `200`

Success.

- object
  - `data` object, required
    - `scanned` integer, required
    - `transcoded` integer, required
    - `rows` object[], required
      - `id` string, required
      - `name` string, nullable, required
      - `result` 'source_gone' | 'undecodable' | 'service_error' | 'binding_absent' | 'transcoded' | 'already_done' | 'not_heic', required
    - `nextAfter` string, nullable, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `429`: More than 10 runs a minute.
- `503`: `binding_absent`: HEIC conversion is not available.
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)