> ## Documentation Index > Fetch the complete documentation index at: https://docs.mint.gg/llms.txt > Use this file to discover all available pages before exploring further. # Get a long-running operation ## OpenAPI ````yaml /api-reference/openapi.json get /v1/operations/{operationId} openapi: 3.1.0 info: title: Mint Public API version: 0.1.0-alpha description: REST API for Mint World and 3D Model generation workflows. license: name: Proprietary url: https://docs.mint.gg/terms-of-service servers: - url: https://api.mint.gg description: Production - url: https://api.dev.mint.gg description: Development - url: http://api.mint.localhost description: Local development security: [] tags: - name: Account description: Developer account and health endpoints. - name: Generation description: Long-running World, 3D Model, and model optimization operations. - name: Conversion description: Long-running 3D Model format conversion operations. - name: Assets description: Generated World, 3D Model, and asset reads. paths: /v1/operations/{operationId}: get: tags: - Generation - Conversion summary: Get a long-running operation operationId: getOperation parameters: - name: operationId in: path required: true schema: type: string responses: '200': description: Long-running generation, optimization, or conversion operation. content: application/json: schema: $ref: '#/components/schemas/Operation' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/TooManyRequests' '503': $ref: '#/components/responses/ServiceUnavailable' security: - bearerApiKey: [] components: schemas: Operation: type: object required: - object - id - type - generationMode - status - prompt - generationPreset - generationModel - optimizationLevel - resource - mintUrl - assets - conversion - createdAt - updatedAt properties: object: const: operation id: type: string type: enum: - world_generation - model_generation - model_optimization - model_conversion generationMode: enum: - auto - review status: enum: - queued - running - preview_ready - succeeded - failed - canceled prompt: type: - string - 'null' description: >- Original developer-visible prompt submitted with the generation request. Null for conversion operations. generationPreset: type: - string - 'null' enum: - fast - standard - production - null description: >- Mint generation tier selected for this operation. Null for conversion operations. generationModel: type: - string - 'null' description: >- Resolved final generation model selected by the generationPreset. Null for conversion operations. optimizationLevel: type: - string - 'null' enum: - light - moderate - aggressive - null description: Optimization intensity for model_optimization operations. resource: oneOf: - type: object required: - type - id properties: type: enum: - world - model id: type: string - type: 'null' mintUrl: type: - string - 'null' format: uri description: >- Mint app URL for the generated world or model when the operation has a resource. assets: $ref: '#/components/schemas/GenerationAssets' conversion: oneOf: - $ref: '#/components/schemas/OperationConversion' - type: 'null' error: oneOf: - type: object required: - code - message properties: code: type: string message: type: string - type: 'null' createdAt: type: string format: date-time updatedAt: type: string format: date-time completedAt: oneOf: - type: string format: date-time - type: 'null' canceledAt: oneOf: - type: string format: date-time - type: 'null' GenerationAssets: oneOf: - $ref: '#/components/schemas/WorldAssets' - $ref: '#/components/schemas/ModelAssets' - type: 'null' OperationConversion: type: object required: - id - assets properties: id: type: - string - 'null' assets: oneOf: - $ref: '#/components/schemas/ConvertedModelAssets' - type: 'null' Problem: type: object required: - type - title - status properties: type: type: string format: uri-reference title: type: string status: type: integer detail: type: string instance: type: string format: uri-reference WorldAssets: type: object required: - caption - colliderMeshUrl - panoUrl - previewImageUrl - radUrl - spzUrls - thumbnailUrl properties: caption: type: - string - 'null' colliderMeshUrl: type: - string - 'null' format: uri panoUrl: type: - string - 'null' format: uri previewImageUrl: type: - string - 'null' format: uri radUrl: type: - string - 'null' format: uri spzUrls: type: - object - 'null' additionalProperties: type: string format: uri thumbnailUrl: type: - string - 'null' format: uri ModelAssets: type: object required: - fbxUrl - glbUrl - glbSizeBytes - objUrl - optimizedGlbUrl - optimizedGlbSizeBytes - previewImageUrl - stlUrl - thumbnailUrl - usdzUrl properties: fbxUrl: type: - string - 'null' format: uri glbUrl: type: - string - 'null' format: uri glbSizeBytes: type: - integer - 'null' minimum: 0 objUrl: type: - string - 'null' format: uri optimizedGlbUrl: type: - string - 'null' format: uri optimizedGlbSizeBytes: type: - integer - 'null' minimum: 0 previewImageUrl: type: - string - 'null' format: uri stlUrl: type: - string - 'null' format: uri thumbnailUrl: type: - string - 'null' format: uri usdzUrl: type: - string - 'null' format: uri ConvertedModelAssets: type: object properties: glbUrl: type: - string - 'null' format: uri objUrl: type: - string - 'null' format: uri stlUrl: type: - string - 'null' format: uri usdzUrl: type: - string - 'null' format: uri fbxUrl: type: - string - 'null' format: uri artifacts: oneOf: - $ref: '#/components/schemas/ConvertedModelArtifacts' - type: 'null' ConvertedModelArtifacts: type: object properties: glb: $ref: '#/components/schemas/ConvertedModelArtifact' obj: $ref: '#/components/schemas/ConvertedModelArtifact' stl: $ref: '#/components/schemas/ConvertedModelArtifact' usdz: $ref: '#/components/schemas/ConvertedModelArtifact' fbx: $ref: '#/components/schemas/ConvertedModelArtifact' ConvertedModelArtifact: type: object required: - format - url - filename - contentType - extension - byteSize - packaging - artifactVersion - primaryPath properties: format: enum: - glb - obj - stl - usdz - fbx url: type: string format: uri filename: type: string contentType: type: string extension: type: string byteSize: type: integer minimum: 0 packaging: enum: - single_file - zip artifactVersion: type: integer minimum: 1 primaryPath: type: string responses: Unauthorized: description: Missing, malformed, inactive, or revoked API key. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' NotFound: description: The requested API resource was not found. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' TooManyRequests: description: Request was rate limited. headers: Retry-After: schema: type: string description: Seconds to wait before retrying. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' ServiceUnavailable: description: Mint could not reach the backend service. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' securitySchemes: bearerApiKey: type: http scheme: bearer description: Mint API key sent as a Bearer token. ````