Skip to main content
GET
List media
The library comes newest first, 18 files to a page. pages says how many pages there are, so ask for page=2, page=3 and so on until you reach it. page starts at 1 and is read as a whole number, so 1.5 reads as 1 and 2abc as 2. 0, a negative number or a value that is not a number, such as abc, answers 400. Each file carries only what a post needs: put its id and path in image, exactly as Create a post takes them. originalName is the name the file was uploaded with, and search matches part of it, with upper and lower case alike:
A video that is still being converted is left out until it is ready. To follow one you just uploaded, use Get media status with the id the upload returned.

Authorizations

Authorization
string
header
required

Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.

Query Parameters

page
integer
default:1

The page, from 1. Default 1. Read as a whole number: 1.5 is 1

Required range: x >= 1

Only files whose original name contains this text. Upper and lower case match alike

Response

One page of the media library

pages
integer

How many pages there are for this search. 0 when the library is empty

results
object[]
Last modified on October 9, 2026