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

# Worlds

> Create worlds and manage API-generated world resources.

World endpoints start generation jobs and manage worlds created through the API.

<Note>
  World generation returns an operation. Poll the
  [operations endpoint](/api/reference/operations/get) until `done` is `true`,
  then read the generated world from the operation response or fetch it by ID.
</Note>

<CardGroup cols={2}>
  <Card title="Generate a world" icon="sparkles" href="/api/reference/worlds/generate">
    **POST** `/marble/v1/worlds:generate`

    Start a world generation job.
  </Card>

  <Card title="List worlds" icon="list" href="/api/reference/worlds/list">
    **POST** `/marble/v1/worlds:list`

    List API-generated worlds.
  </Card>

  <Card title="Get a world" icon="box" href="/api/reference/worlds/get">
    **GET** `/marble/v1/worlds/{world_id}`

    Retrieve a world, including generated asset URLs when they are available.
  </Card>

  <Card title="Export a world" icon="download" href="/api/reference/worlds/export">
    **POST** `/marble/v1/worlds/{world_id}:export`

    Download PLY splats or start a high-quality mesh export.
  </Card>

  <Card title="Delete a world" icon="trash-2" href="/api/reference/worlds/delete">
    **DELETE** `/marble/v1/worlds/{world_id}`

    Permanently delete a world and its associated assets.
  </Card>
</CardGroup>

## Generation flow

<Steps>
  <Step title="Prepare inputs">
    For local image or video files, first create a
    [media asset upload](/api/reference/media-assets/prepare-upload).
  </Step>

  <Step title="Generate">
    Call [Generate a world](/api/reference/worlds/generate). Save the returned
    `operation_id`.
  </Step>

  <Step title="Poll">
    Call [Get an operation](/api/reference/operations/get) until the operation
    completes.
  </Step>

  <Step title="Use assets">
    Read the world response for Marble links, thumbnails, panorama imagery,
    Gaussian splat files, and mesh assets. Use
    [Export a world](/api/reference/worlds/export) for cached `.ply` splat
    downloads or high-quality mesh exports. If you render `.spz` files in a
    third-party engine, see
    [Rendering Marble SPZ files in third-party engines](/api/rendering-spz).
  </Step>
</Steps>