List worlds
List worlds with optional filters.
Returns worlds created through the API with optional filtering and pagination.
Args: request: List request with optional filters:
- page_size: Number of results per page (default: 10)
- page_token: Pagination token from previous response
- status: Filter by status (e.g., “COMPLETED”)
- model: Filter by model name (e.g., “marble-1.0-plus”)
- tags: Filter by tags (matches worlds with any tag)
- is_public: Filter by visibility (true=public, false=private, null=all)
- created_after: Filter by creation time (after timestamp)
- created_before: Filter by creation time (before timestamp)
- sort_by: Sort order (“created_at” or “updated_at”)
Returns: ListWorldsResponse with worlds list and next_page_token for pagination.
Raises: HTTPException: 400 if invalid parameters HTTPException: 500 if request fails
Authorizations
API key for authentication. Get your key from the developer portal.
Body
Request to list API-generated worlds with optional filters.
Filter worlds created after this timestamp (inclusive)
Filter worlds created before this timestamp (exclusive)
Filter by visibility. true=public only, false=private only, null=all
Filter by model used for generation. Legacy names are deprecated; use the new lowercase names.
marble-1.0-draft, marble-1.0, marble-1.1, marble-1.1-plus Number of results per page (1-100)
1 <= x <= 100Cursor token for pagination (opaque base64 string from previous response). Use cursor from next_page_token in previous response for consistent pagination.
Sort results by created_at or updated_at
created_at, updated_at Filter by world status
SUCCEEDED, PENDING, FAILED, RUNNING Filter by tags (returns worlds with ANY of these tags)