PostifyPostify Docs
API ReferenceMedia

Start a media upload

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`.

POST
/v1/media/uploads

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.

Authorization

AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/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" \  -H "Content-Type: application/json" \  -d '{    "filename": "string",    "content_type": "string"  }'
{  "asset_id": "string",  "upload_url": "string",  "method": "PUT",  "expires_at": "2019-08-24T14:15:22Z"}

List media assets GET

Lists the organization's media library, newest first, with cursor pagination. Use an asset's `url` as `media[].url` when creating posts.

Complete a media upload POST

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.