Skip to main content
GET
List references
Your own references, newest first, with limit and cursor for paging: send the next_cursor of one page as cursor to get the next, until it is null. Each entry’s kind says what it is (object, location, pose, outfit, or audio); the four image kinds carry image_url, an audio reference carries audio_url. handle is what a prompt mentions as @handle; id is what DELETE /v1/references/{reference_id} takes. See Characters and references for how mentions work.

Authorizations

Authorization
string
header
required

An API key from Settings → API, sent as Authorization: Bearer mage_sk_…. Keys are for server-side code only.

Query Parameters

limit
integer
default:50

Entities per page, 1 to 200; 50 when omitted.

Required range: 1 <= x <= 200
cursor
string

The next_cursor of the previous page.

Response

One page of references.

data
object[]
required

The page, newest first.

next_cursor
string | null
required

Send as cursor for the next page; null on the last page.

Last modified on September 18, 2026