Get World

Get a world by ID.

Retrieves a world's details including generated assets if available. Only the world owner or users with access to public worlds can retrieve them.

Args: world_id: The unique identifier of the world.

Returns: World object with world_id, display_name, tags, assets, created_at, updated_at, permission, model, world_prompt, and world_marble_url.

Raises: HTTPException: 404 if world not found or access denied

get/marble/v1/worlds/{world_id}

Request

Base URL
https://api.worldlabs.ai
Auth
API key in header WLT-Api-Key
TypeScript
https://skmtc.dev/worldlabs/apis/marble-public-api-v1/docs/marble/v1/worlds/:world_id/get.ts
A function with typed inputs. Its response is checked against the schema.

world_idstring required

Successful Response

created_atstring date-time nullable

Creation timestamp

display_namestring required

Display name

modelstring nullable

Model used for generation

tagsstring[] nullable

Tags associated with the world

updated_atstring date-time nullable

Last update timestamp

world_idstring required

World identifier

world_marble_urlstring required

World Marble URL

{
  "world_prompt": {
    "image_prompt": {
      "extension": "jpg"
    }
  }
}

Nov 3, 20264a3ed614672e Revision changes
- info
  added depth-pano image inpaint-pano multi-image text video discriminator mapping keys to the / response property for the response status