---
title: "Probe and finalize an uploaded media file"
method: POST
path: "/complete-media/{mediaFileId}"
tags: ["Media"]
---

# Probe and finalize an uploaded media file

`POST /complete-media/{mediaFileId}`

Optionally run the server-side media probe immediately after uploading
bytes to the pre-signed URL. This call is not required: scheduling also
probes media that is still uploading.

## Path parameters

- `mediaFileId` string, required

## Response `200`

Media probe completed

- object
  - `success` boolean, required
  - `mediaFile` object, required
    - `_id` string, required
    - `type` string, nullable
    - `mimeType` string, nullable
    - `fileName` string, nullable
    - `url` string, uri, nullable
    - `status` string, nullable
    - `metadata` object, nullable

## Other responses

- `400` — Invalid media ID or uploaded media failed validation
- `404` — Media file not found
- `409` — Media was deleted or failed concurrently while being probed
- `500` — Failed to complete media upload
- `503` — Media probe service or uploaded object is temporarily unavailable

---

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