Skip to main content
GET
List media in vault list

Authorizations

Authorization
string
header
required

Link access token for one Sandbox, Test, or Live authorization.

x-linked-account-id
string
header
required

Selects one of the authorization's linked accounts via the x-linked-account-id header.

Headers

x-linked-account-id
string
required

The linked account to use. The user must have shared it with your app. A missing account returns linked_account_required; an account outside your access returns linked_account_not_granted.

Example:

"conn_example123"

Path Parameters

listId
number | null

Query Parameters

limit
integer
default:24

Number of items to return (1-40, default: 24)

Required range: 1 <= x <= 40
cursor
string | null

Cursor from the previous response. Send it to get the next page.

sortBy
enum<string>
default:recent

Sort media by: recent, most-liked, or highest-tips

Available options:
recent,
most-liked,
highest-tips
sortDirection
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
query
string

Text to search for

Maximum string length: 100
mediaType
enum<string>

Filter by media type

Available options:
photo,
video,
audio
beforePublishDate
string

Only return media published before this date

Response

Successful response

items
object[]
required
page
object
required