---
title: "Check media compatibility before uploading"
method: POST
path: "/media/check"
tags: ["Media"]
---

# Check media compatibility before uploading

`POST /media/check`

Preflight a file against the platforms connected to your workspace and find out which (if any) would reject it by size or format — before you upload or post. Provide ONE of: a public `url` (we read its size/type via a HEAD request), an existing `media_id`, or an explicit `size_bytes` + `mime`. Use this to warn the user ("this 995 MB video won't post to Instagram") and confirm before uploading.

## Request body

- object
  - `url` string — Public URL of the file to check (HEAD-probed for size + type).
  - `media_id` string — Id of an already-uploaded library item to check.
  - `size_bytes` integer — File size in bytes (use with `mime` when you already know them).
  - `mime` string — MIME type, e.g. "video/mp4" (use with `size_bytes`).

## Response `200`

Compatibility result

- object
  - `file` object
    - `size_bytes` integer, nullable
    - `mime` string, nullable
    - `size_known` boolean
  - `connected_platforms` string[]
  - `compatible` boolean — true when no connected platform would reject the file.
  - `warnings` object[]
    - `platform` string
    - `display_name` string
    - `reasons` string[]
  - `summary` string, nullable — One-line human summary, or null when fully compatible.

## Other responses

- `400` — Missing/invalid parameters

---

[API](https://skmtc.dev/omnisocials/apis/omnisocials-api.md) · [All operations](https://skmtc.dev/omnisocials/apis/omnisocials-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisocials/omnisocials-api/revisions/e53b89af0b98/schema)