Operations - World Labs

Long-running endpoints return an operation_id. Use the operations endpoint to check status, inspect progress metadata, and retrieve the final response.

Get an operation

GET /marble/v1/operations/{operation_id}Poll a world-generation or pano operation until done is true.

Response states

done: false: The job is still running. Check metadata for progress details when present.
done: true with error: null: The job completed. Read response for the generated result.
done: true with error: The job failed. Use the error code and message to decide whether to retry or adjust the request.

Get an operationGet an operation by ID. Poll this endpoint to check the status of a long-running operation. When done=true, the response field contains the generated world. Args: operation_id: The operation identifier from /worlds:generate. Returns: GetOperationResponse[World] with: - operation_id: Operation identifier - created_at: Creation timestamp - updated_at: Last update timestamp - expires_at: Expiration timestamp - done: true when complete, false while in progress - error: Error details if failed, null otherwise - metadata: Progress information and world_id - response: Generated World if done=true, null otherwise Raises: HTTPException: 401 if unauthorized HTTPException: 404 if operation not found HTTPException: 500 if request fails

⌘I

Get an operation

​Response states

Response states