---
title: "Search Your Library"
method: GET
path: "/library"
---

# Search Your Library

`GET /library`

## Request

- Base URL: `https://pixeldojo.ai/api/v1`
- URL: `https://pixeldojo.ai/api/v1/library`
- Auth: HTTP bearer

Search the key owner's media library: saved Library items (permanent) plus recent generations, newest first. Saved copies never expire; recent generation URLs are deleted 1 hour after the job completes (expiredCount reports dropped matches).

## Query parameters

- `q` string
- `model` string
- `modality` 'image' | 'video' | 'audio'
- `limit` integer

## Response `200`

Matching library items

- object
  - `items` object[], required
    - `url` string, required
    - `prompt` string
    - `model` string
    - `modality` 'image' | 'video' | 'audio'
    - `source` 'saved' | 'api' | 'kept', required
    - `createdAt` string, date-time, required
  - `count` integer, required
  - `expiredCount` integer

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/pixeldojo/apis/pixeldojo-api.md) · [All operations](https://skmtc.dev/pixeldojo/apis/pixeldojo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pixeldojo/apis/pixeldojo-api/revisions/a079cd502a93?raw)