PostifyPostify Docs
API ReferenceMedia

List media assets

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

GET
/v1/media

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

Authorization

AuthorizationBearer <token>

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

In: header

Query Parameters

limit?integer

Page size (1–100).

Range1 <= value <= 100
Default25
after?string

Opaque cursor from a previous page's next_cursor.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/media"
{  "data": [    {      "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"    }  ],  "has_more": true,  "next_cursor": "string"}

List channels GET

Lists every social account connected to the organization, with connection health. Use a channel's `id` when creating post variants. Not paginated — the channel count is plan-bounded.

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