# list_reference_sets

List the reference sets (the user's trained styles / custom models) for a workspace.

Returns compact summaries; optional fulltext matches on name/description, and an optional category  
narrows to one kind of set. Only sets that are ready to generate with are listed: archived sets,  
and empty ones (no usable input files, no active finetune and no prompt fragments) are omitted.

For forge lifecycle guidance, call get\_forge\_instructions.

## Parameters

| Parameter             | Type                    | Default | Description                                                                                                                                                                                                                                                                                                                                                        |
| --------------------- | ----------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| filter                | ReferenceSetQueryFilter | —       | Query filters                                                                                                                                                                                                                                                                                                                                                      |
| fulltext              | string                  | —       | Search reference set name/description                                                                                                                                                                                                                                                                                                                              |
| category              | enum                    | —       | Only sets of this category, e.g. \`animation\` for the motions a rigged mesh can play.One of: general, character, object, scene, animation, brand, camera\_movement, camera\_angle, camera\_framing, camera\_lens, scene\_lighting, scene\_composition, scene\_atmosphere, time\_and\_motion, genre\_look, optical\_effect, visual\_effect, character\_performance |
| pagination            | PaginationInput         | —       | Parameters driving result pagination                                                                                                                                                                                                                                                                                                                               |
| limit                 | integer1–100            | 20      | Maximum number of results to return                                                                                                                                                                                                                                                                                                                                |
| cursor                | string                  | —       | Cursor from which to return results                                                                                                                                                                                                                                                                                                                                |
| workspace\_idrequired | string (uuid)           | —       | The user's workspace id.                                                                                                                                                                                                                                                                                                                                           |