Skip to main content
GET
List media generations
Returns generated media items owned by the authenticated account. Use it to show a user their saved image, video, audio, and file outputs. Use search to match media filenames and prompts. Search cursors are opaque: pass the returned nextCursor value back unchanged instead of parsing it.

Authorization

string
required
Bearer API key. Format: Bearer gx_your_api_key.

Query parameters

Request

Response

array
Media items for the requested page.
string
Cursor for the next page. Omitted when there is no next page.
Media items include:

Errors

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

type
enum<string>[]

Optional media type filter. Repeat for multiple values.

Available options:
image,
video,
audio,
file
fileSubtype
enum<string>[]

Optional file subtype filter. Repeat for multiple values.

Available options:
pdf,
word,
spreadsheet,
presentation,
code
sourceFilter
enum<string>

generated or uploaded.

Available options:
generated,
uploaded
isFavorite

Use canonical true to return only favorites. false and legacy non-true strings behave like omitting the filter. Canonical true/false input.

folderId
string

Folder ID, empty for no filter, or literal null for uncategorized media.

cursor
string

Cursor from the previous response nextCursor.

Pattern: ^(?:[a-fA-F0-9]{24}|atlas:v1:[A-Za-z0-9_-]+|mongo:v2:[A-Za-z0-9_-]+|pg:v1:[A-Za-z0-9_-]+)$
Example:

"0123456789abcdef01234567"

limit
integer
default:30

Page size from 1 to 100. Defaults to 30.

Required range: 1 <= x <= 100

Search text.

sortOrder
enum<string>

newest or oldest. Defaults to newest.

Available options:
newest,
oldest
createdFrom
string<date-time>

Inclusive created-at lower bound.

createdTo
string<date-time>

Inclusive created-at upper bound.

Response

Media items and pagination cursor.

items
object[]
required
nextCursor
string | null