---
title: "Get media status"
method: GET
path: "/media/{id}/status"
tags: ["Uploads"]
---

# Get media status

`GET /media/{id}/status`

## Request

- Base URL: `https://api.postiz.com/public/v1`
- URL: `https://api.postiz.com/public/v1/media/{id}/status`
- Auth: API key in header `Authorization`

Check whether a file uploaded with adjust set to true finished adjusting. A failed adjustment returns status "ready" with a warning: the original file was kept and is used for publishing.

## Path parameters

- `id` string, required

## Response `200`

Media status

- object
  - `id` string
  - `path` string
  - `status` 'processing' | 'ready' | 'failed'
  - `warning` string: Present when the adjustment failed and the original file was kept
  - `error` string: Present with status "failed", only when the adjustment failed and the original file's format cannot be published as is

## Other responses

- `404`: Media not found

## Changes

- **2026-10-20** `cfd01e187be0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/postiz/apis/postiz-public-api/changes/media/:id/status/get.md)

---

[API](https://skmtc.dev/postiz/apis/postiz-public-api.md) - [All operations](https://skmtc.dev/postiz/apis/postiz-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postiz/apis/postiz-public-api/revisions/269b4fe5c86b?raw)