Worlds

Listar mundos

Lista mundos Marble da World Labs concluídos criados por meio do TokenLab

POST
/v1/worlds/list

Lista mundos Marble concluídos no Workspace atual.

Use GET /v1/tasks/{id} para tarefas de geração pendentes ou com falha. Esta lista retorna mundos concluídos que o TokenLab indexou após a geração.

Corpo da requisição

page_sizeintegerpadrão: 20

Número de mundos a serem retornados, de 1 a 100.

page_tokenstring

Token de paginação da resposta anterior. Trate-o como um valor opaco.

statusstring

Filtro opcional: SUCCEEDED, PENDING, RUNNING ou FAILED. Este endpoint lista mundos concluídos; os outros três valores retornam uma lista vazia. Consulte as tarefas de geração para acompanhar o progresso delas.

modelstring

Filtro de modelo opcional. Também corresponde a mundos criados com um modelo que não é mais oferecido.

tagsarray

Filtro de tags opcional. Um mundo corresponde quando possui pelo menos uma das tags.

is_publicboolean

Filtro de visibilidade opcional.

created_afterstring

Retorna apenas mundos criados neste ou após este timestamp ISO 8601, por exemplo 2026-10-01T00:00:00Z.

created_beforestring

Retorna apenas mundos criados antes deste timestamp ISO 8601.

sort_bystringpadrão: created_at

Ordenar por created_at ou updated_at.

sort_orderstringpadrão: desc

Direção da ordenação: asc ou desc.

Resposta

worldsarray

Array de registros de mundos, cada um com world_id e, quando disponível, display_name, world_marble_url, model, tags, created_at e updated_at.

next_page_tokenstring | null

Token para a próxima página, ou null.

Requisição

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"}

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Corpo da requisição

application/json

Resposta

application/json

application/json