TokenLab

Worlds

List Worlds

Lists completed World Labs Marble worlds created through TokenLab

POST
/v1/worlds/list

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

page_sizeintegerdefault: 20

Number of worlds to return, from 1 to 100.

page_tokenstring

Pagination token from the previous response. Treat it as an opaque value.

statusstring

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.

modelstring

Optional model filter. It also matches worlds made with a model that is no longer offered.

tagsarray

Optional tag filter. A world matches when it has at least one of the tags.

is_publicboolean

Optional visibility filter.

created_afterstring

Only return worlds created at or after this ISO 8601 timestamp, for example 2026-10-01T00:00:00Z.

created_beforestring

Only return worlds created before this ISO 8601 timestamp.

sort_bystringdefault: created_at

Sort by created_at or updated_at.

sort_orderstringdefault: desc

Sort direction: asc or desc.

Response

worldsarray

Array of world records, each with world_id and, when available, display_name, world_marble_url, model, tags, created_at, and updated_at.

next_page_tokenstring | null

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
AuthorizationBearer <token>

API Key authentication. Create or manage API keys in Dashboard > API > API Keys.

In: header

Request Body

application/json

Response

application/json

application/json