GET/v1/media

listMedia

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.

Required scope:posts:read

Parameters

limitquery · integeroptional

Page size (1–100).

afterquery · stringoptional

Opaque cursor from a previous page's `next_cursor`.

Responses

200MediaList

One page of media assets.

400invalid_requestvalidation_failed
401authentication_requiredinvalid_api_key
403insufficient_scopefeature_not_enabled
429rate_limitedquota_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

curl https://app.usepostify.com/v1/media \
  -H "Authorization: Bearer postify_live_XXXXXXXXXXXXXXXX"