Worlds
List Worlds
Lists completed World Labs Marble worlds created through TokenLab
List completed Marble Worlds in the current Workspace.
Use /v1/worlds/generations/{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.
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 Marble model filter.
Optional tag filter.
Optional visibility filter.
Only return worlds created after this timestamp.
Only return worlds created before this timestamp.
created_atSort by created_at or updated_at.
descSort direction: asc or desc.
Response
Array of world records.
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