v1

latestOpenAPI 3.1.02026-07-26104450.2 KB

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}

Path parameters

world_idstring required

Response

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

Example response

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