PostifyPostify Docs
API ReferenceMedia

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.

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

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.

Authorization

AuthorizationBearer <token>

Organization API key as a Bearer token (postify_live_…).

In: header

Path Parameters

id*string

Asset identifier.

Length1 <= length

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/media/uploads/string/complete"
{  "id": "string",  "filename": "string",  "content_type": "string",  "kind": "image",  "status": "pending",  "url": "string",  "size_bytes": -9007199254740991,  "width": -9007199254740991,  "height": -9007199254740991,  "duration_sec": 0,  "created_at": "2019-08-24T14:15:22Z"}

Start a media upload POST

Issues a presigned upload ticket: PUT the raw file bytes to `upload_url` with the same `Content-Type`, then call POST /v1/media/uploads/{id}/complete. The asset kind (image/video/audio) is inferred from `content_type`.

List posts GET

Lists the organization's posts, newest first, with cursor pagination. Each post carries its per-channel variants and latest delivery outcomes.