> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mint.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Asset Packs

> Generate, review, retrieve, and recover coordinated groups of 3D assets.

Use an Asset Pack when one request should create a coordinated collection rather than one 3D Model.

## Generate an Asset Pack

Describe the pack and let Mint plan the individual assets, category, and shared visual direction.

```json theme={null}
{
  "prompt": "Create 4 assets for a sci-fi game pack"
}
```

Use optional controls only when you need them:

* `itemCount` sets an exact count from 2–25. Otherwise Mint follows a count in the prompt, or creates 8 when none is given.
* `assetPackType` overrides the inferred category. If no specialized category fits, Mint uses `general_asset_pack`.
* `styleGuide` overrides the style inferred from the prompt. For example: `"Low-poly sci-fi props with cool gray metal and cyan accents"`.
* `name` sets the title shown in Mint.
* `riggingPose` prepares humanoid character items for later rigging; it does not rig or animate them.

Use one `imageUrl` or 2–8 `sourceImages`, never both. `generationMode` defaults to the recommended `auto` workflow; choose a [preset](/developers/api-overview#presets) for the desired speed, quality, and cost.

## Review and revise Previews

Item Previews are fast visual proposals, not the final 3D Models. Set `generationMode: "review"` to pause at them; otherwise `auto` continues without another lifecycle call.

* Approve all eligible items with `POST /v1/asset-packs/{assetPackId}:approve` and no body.
* Approve selected items with `{ "itemIds": ["..."] }`.
* Revise all or selected items with `POST /v1/asset-packs/{assetPackId}:revise`, `feedback`, and optional `scope`, `itemIds`, `name`, `revisionEditStrength`, or `riggingPose`.

Approval is safe against duplicate final work: items that already started or finished are reused, and Mint starts only the requested Preview-ready items that have not started yet.

## Retrieve items and files

Read the pack with `GET /v1/asset-packs/{assetPackId}`. Use `GET /v1/assets/asset_pack/{assetPackId}/artifact-manifest` for the pack's available files and item outputs.

## Handle partial success

Asset Pack items finish independently. Preserve successful items when the operation is `partially_succeeded`.

* Retry a failed Preview with `POST /v1/asset-packs/{assetPackId}:retry`.
* Regenerate only failed final items with `POST /v1/asset-packs/{assetPackId}:regenerate-failed-items`.

To animate eligible character items, continue to [Animation](/developers/animation).