Sign in
Files

List saved items

Returns active saved items owned by the authenticated account, newest first. Each item includes every saved asset with a durable file_path for reuse in compatible generation APIs and a temporary signed URL for previewing or downloading. Filter by type to find characters, references, voices, moodboards, or brand kits. To fetch the next page, pass the response's next_cursor as cursor.

get/v1/saved-items

Query parameters

type'character' | 'reference' | 'voice' | 'moodboard' | 'brand_kit'
Example:character

Only return saved items of this type.

limitinteger
Example:20

Maximum number of saved items to return. Defaults to 20.

cursorstring

Opaque pagination cursor from the previous response's next_cursor.

Response

200

next_cursorstring nullable required

Cursor for the next page, or null when there are no more saved items.

Example response

{
  "items": [
    {
      "id": "cuid-example",
      "type": "character",
      "name": "Alex",
      "assets": [
        {
          "file_path": "saved-items/user-id/item-id/image.png",
          "media_kind": "IMAGE",
          "is_primary": true,
          "url_expires_at": "2026-09-17T00:00:00.000Z"
        }
      ]
    }
  ]
}

Changes

Changed in 1 of the 66 revisions of this API.1