Skip to main content
GET
/
v1
/
operations
/
{operationId}
Get a long-running operation
curl --request GET \
  --url https://api.mint.gg/v1/operations/{operationId} \
  --header 'Authorization: Bearer <token>'
{
  "object": "<unknown>",
  "id": "<string>",
  "prompt": "<string>",
  "generationModel": "<string>",
  "resource": {
    "id": "<string>"
  },
  "mintUrl": "<string>",
  "assets": {
    "caption": "<string>",
    "colliderMeshUrl": "<string>",
    "panoUrl": "<string>",
    "previewImageUrl": "<string>",
    "radUrl": "<string>",
    "spzUrls": {},
    "thumbnailUrl": "<string>"
  },
  "conversion": {
    "id": "<string>",
    "assets": {
      "glbUrl": "<string>",
      "objUrl": "<string>",
      "stlUrl": "<string>",
      "usdzUrl": "<string>",
      "fbxUrl": "<string>",
      "artifacts": {
        "glb": {
          "url": "<string>",
          "filename": "<string>",
          "contentType": "<string>",
          "extension": "<string>",
          "byteSize": 1,
          "artifactVersion": 2,
          "primaryPath": "<string>"
        },
        "obj": {
          "url": "<string>",
          "filename": "<string>",
          "contentType": "<string>",
          "extension": "<string>",
          "byteSize": 1,
          "artifactVersion": 2,
          "primaryPath": "<string>"
        },
        "stl": {
          "url": "<string>",
          "filename": "<string>",
          "contentType": "<string>",
          "extension": "<string>",
          "byteSize": 1,
          "artifactVersion": 2,
          "primaryPath": "<string>"
        },
        "usdz": {
          "url": "<string>",
          "filename": "<string>",
          "contentType": "<string>",
          "extension": "<string>",
          "byteSize": 1,
          "artifactVersion": 2,
          "primaryPath": "<string>"
        },
        "fbx": {
          "url": "<string>",
          "filename": "<string>",
          "contentType": "<string>",
          "extension": "<string>",
          "byteSize": 1,
          "artifactVersion": 2,
          "primaryPath": "<string>"
        }
      }
    }
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "completedAt": "2023-11-07T05:31:56Z",
  "canceledAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Mint API key sent as a Bearer token.

Path Parameters

​
operationId
string
required

Response

Long-running generation, optimization, or conversion operation.

​
object
any
required
​
id
string
required
​
type
enum<string>
required
Available options:
world_generation,
model_generation,
model_optimization,
model_conversion
​
generationMode
enum<string>
required
Available options:
auto,
review
​
status
enum<string>
required
Available options:
queued,
running,
preview_ready,
succeeded,
failed,
canceled
​
prompt
string | null
required

Original developer-visible prompt submitted with the generation request. Null for conversion operations.

​
generationPreset
enum<string> | null
required

Mint generation tier selected for this operation. Null for conversion operations.

Available options:
fast,
standard,
production,
null
​
generationModel
string | null
required

Resolved final generation model selected by the generationPreset. Null for conversion operations.

​
optimizationLevel
enum<string> | null
required

Optimization intensity for model_optimization operations.

Available options:
light,
moderate,
aggressive,
null
​
resource
object | null
required
​
mintUrl
string<uri> | null
required

Mint app URL for the generated world or model when the operation has a resource.

​
assets
object
required
​
conversion
object | null
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
error
object | null
​
completedAt
string<date-time> | null
​
canceledAt
string<date-time> | null