Worlds
List Worlds
Lists completed World Labs Marble worlds created through TokenLab
List completed Marble Worlds in the current Workspace.
Use GET /v1/tasks/{id} for pending or failed generation tasks. This list returns completed worlds that TokenLab has indexed after generation.
Request Body
20Number of worlds to return, from 1 to 100.
Pagination token from the previous response. Treat it as an opaque value.
Optional filter: SUCCEEDED, PENDING, RUNNING, or FAILED. This endpoint lists completed worlds; the other three values return an empty list. Query generation tasks for their progress.
Optional model filter. It also matches worlds made with a model that is no longer offered.
Optional tag filter. A world matches when it has at least one of the tags.
Optional visibility filter.
Only return worlds created at or after this ISO 8601 timestamp, for example 2026-10-01T00:00:00Z.
Only return worlds created before this ISO 8601 timestamp.
created_atSort by created_at or updated_at.
descSort direction: asc or desc.
Response
Array of world records, each with world_id and, when available, display_name, world_marble_url, model, tags, created_at, and updated_at.
Token for the next page, or null.
Request
curl -X POST "https://api.tokenlab.sh/v1/worlds/list" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{"page_size": 20, "status": "SUCCEEDED", "model": "marble-1.1"}'{ "worlds": [ { "display_name": "string", "world_id": "string", "world_marble_url": "http://example.com", "assets": {}, "created_at": "2019-08-24T14:15:22Z", "model": "string", "permission": {}, "tags": [ "string" ], "updated_at": "2019-08-24T14:15:22Z", "world_prompt": {} } ], "next_page_token": "string"}Authorization
BearerAuth API Key authentication. Create or manage API keys in Dashboard > API > API Keys.
In: header
Request Body
application/json
Response
application/json
application/json