> ## 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.

# Worlds

> Generate, review, retrieve, and retry explorable Worlds.

Use the World API to create an explorable spatial scene from a prompt and optional image guidance.

## Generate a World

Call `POST /v1/worlds:generate`. Add `name` only for a specific Mint title; Mint derives one when omitted. `generationMode` defaults to `auto`, and `generationPreset` defaults to `standard`. See [Presets](/developers/api-overview#presets) for the tradeoffs.

```json theme={null}
{
  "prompt": "A quiet sci-fi greenhouse with glass walkways",
  "name": "Sci-fi greenhouse"
}
```

Use one `imageUrl` or 2–8 `sourceImages`, never both.

## Review and revise a Preview

The Preview is a fast visual proposal, not the final World. The recommended `auto` mode continues automatically; set `generationMode: "review"` to pause at `preview_ready`.

* Approve with `POST /v1/worlds/{worldId}:approve`. Send no body.
* Revise with `POST /v1/worlds/{worldId}:revise` and `feedback`. You can also set `name`, `revisionEditStrength`, or the next `generationMode`.

## Retrieve the World and its files

Read `operation.resource.id`, then call `GET /v1/worlds/{worldId}`. The World response includes the available Preview, panorama, splat, and collider files.

Use `GET /v1/assets/world/{worldId}/artifact-manifest` for the complete runtime
manifest. Worlds stream differently from ordinary downloadable assets: load the
final RAD file from `runtime.runtimeUrl` and the matching invisible collider
from `runtime.collider.runtimeUrl`. Preview images remain in `artifacts`; the
RAD runtime is intentionally not duplicated there.

## Retry a failed World

Use `POST /v1/worlds/{worldId}:retry` for a terminal failed generation. The
optional body can replace `prompt`, `name`, `generationMode`, or
`generationPreset`. Temporary failures can reuse the original prompt. Moderated
or otherwise unknown failures require a changed `prompt`; account or invalid
input failures must be resolved before starting again.