POST/v1/media/uploads/{id}/complete

completeMediaUpload

Complete a media upload. Finalizes an uploaded asset after the PUT succeeds: probes the object, extracts a poster frame for videos, and marks it `ready`. Safe to retry — finalizing an already-ready asset is a no-op.

Required scope:posts:write

Parameters

idpath · stringrequired

Asset identifier.

Responses

200MediaAsset

The finalized asset.

400invalid_request validation_failed

401authentication_required invalid_api_key

403insufficient_scope feature_not_enabled

404resource_not_found

409resource_conflict

429rate_limited quota_exhausted

500internal_error

Errors are RFC 9457 problem+json with a stable code and a request_id — each code above links to its own page.

Example

POST /v1/media/uploads/{id}/complete

curl -X POST https://app.usepostify.com/v1/media/uploads/post_9x2y3z0001/complete \
  -H "Authorization: Bearer postify_live_XXXXXXXXXXXXXXXX"