---
title: "List World Labs worlds"
method: POST
path: "/v1/worlds/list"
tags: ["Worlds"]
---

# List World Labs worlds

`POST /v1/worlds/list`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/worlds/list`
- Auth: HTTP bearer

Lists World Labs worlds created through TokenLab for the authenticated organization. Results only include resources created through TokenLab.

## Request body

- object
  - `page_size` integer
  - `page_token` string, nullable
  - `status` 'SUCCEEDED' | 'PENDING' | 'FAILED' | 'RUNNING', nullable
  - `model` 'marble-1.0' | 'marble-1.1' | 'marble-1.1-plus' | 'marble-1.0-draft', nullable
  - `tags` string[], nullable
  - `is_public` boolean, nullable
  - `created_after` string, date-time, nullable
  - `created_before` string, date-time, nullable
  - `sort_by` 'created_at' | 'updated_at'
  - `sort_order` 'asc' | 'desc': TokenLab extension for ascending or descending order.

## Response `200`

World list

- object
  - `worlds` object[], required
    - `display_name` string
    - `world_id` string, required
    - `world_marble_url` string, uri
    - `assets` object
    - `created_at` string, date-time, nullable
    - `model` string, nullable
    - `permission` object
    - `tags` string[], nullable
    - `updated_at` string, date-time, nullable
    - `world_prompt` object
  - `next_page_token` string, nullable

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)