v1

latestOpenAPI 3.1.02026-07-26104450.2 KB

Get Operation

Get 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 - cost: Settled credit cost breakdown; populated only when the operation completed successfully (done=true with no error) and a public price is known for its operation type. Failed or in-progress operations return null.

Raises: HTTPException: 401 if unauthorized HTTPException: 404 if operation not found HTTPException: 500 if request fails

get/marble/v1/operations/{operation_id}

Path parameters

operation_idstring required

Response

Successful Response

created_atstring date-time nullable

Creation timestamp

doneboolean required

True if the operation is completed

expires_atstring date-time nullable

Expiration timestamp

metadataobject nullable

Service-specific metadata, such as progress percentage

operation_idstring required

Operation identifier

updated_atstring date-time nullable

Last update timestamp

Example response

{
  "response": {
    "world_prompt": {
      "image_prompt": {
        "extension": "jpg"
      }
    }
  }
}