Get user's generation history by type (Roles: user)

Type of generation history to retrieve

Number of items per page (default: 20, max: 100)

Page number (1-based, default: 1)

Free-text search; whitespace-separated terms are AND-ed over tags, prompts, user inputs (hints), art style, perspective, and label

Labels picked deliberately (as opposed to typed). Each must match the item's tags EXACTLY, and they AND with each other and with search. Unlike search, this never matches prompts or other text, so picking a label narrows the list to the items actually carrying it. Values are normalized the same way stored tags are, so either "two-handed" or "Two Handed" works.

When true, return only items that have a finished generated output for this type (drops image-only/intermediate items). Applied before pagination so number_pages reflects the filtered count. Combines with search as AND. No-op for types without outputs (audio, generated_image).

Inclusive lower bound (unix seconds) on the item's creation date. Combines with search/outputsOnly as AND; applied before pagination so number_pages reflects the filtered count.

Inclusive upper bound (unix seconds) on the item's creation date. Callers pass end-of-day to keep a single-day range inclusive.

Which surface the items were generated from: web (default, studio generations only), api (public API/MCP generations only - these expire 7 days after creation unless kept), or all.

Spritesheets and generated images only: the history id of a 3D model (three_d_asset), to list only the sheets or stills rendered from it (3D to sprite). Combines with the other filters as AND, before pagination. Ignored for other types.

One item by its history id (at most one result). Lets the client re-read an item it already holds, e.g. a sprite whose sheet urls were served watermarked before the viewer subscribed. Combines with the other filters as AND.