# get_reference_set

Fetch everything about a reference set: its metadata, files and trained finetunes.

A reference set is a curated collection of reference files (images, video, audio; optionally  
captioned) describing a character, style or concept, and may carry trained finetunes. Call this to  
inspect, analyze, or describe a reference set. It returns the set's name, description, category,  
status and color palette, every attached reference file with its download URL, content type,  
caption, and multi-view tag, the set's logo and font files as \`brand\_assets\`, and its trained  
finetunes as \`trained\_bindings\` (a \`voice\` binding means the set speaks in a trained voice on that  
text-to-speech model).

Use the returned \`file\_id\` / \`url\` to act on individual files (e.g. analyze\_media, or as a  
reference input for generation). Pass a \`brand\_assets\` logo as a guidance image only when the  
user asks for it. Do not surface raw UUIDs or download URLs in prose.

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

## Parameters

| Parameter                  | Type          | Default | Description                                                                                                                         |
| -------------------------- | ------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| reference\_set\_idrequired | string (uuid) | —       | ID of the reference set — a \`set\_id\` from \`list\_reference\_sets\`, or the id from an @-mentioned reference\_set context entry. |
| workspace\_idrequired      | string (uuid) | —       | The user's workspace id.                                                                                                            |