Skip to content

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

ParameterTypeDefaultDescription
filterReferenceSetQueryFilter—Query filters
fulltextstring—Search reference set name/description
categoryenum—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
paginationPaginationInput—Parameters driving result pagination
limitinteger1–10020Maximum number of results to return
cursorstring—Cursor from which to return results
workspace_idrequiredstring (uuid)—The user's workspace id.