List media
List media
Page through the media library to reuse a file in a post instead of uploading it again.
GET
List media
The library comes newest first, 18 files to a page.
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.
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:
Authorizations
Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.
Query Parameters
The page, from 1. Default 1. Read as a whole number: 1.5 is 1
Required range:
x >= 1Only files whose original name contains this text. Upper and lower case match alike
Last modified on October 9, 2026