Skip to main content
POST
/
v1
/
operations
/
{operationId}
:revise
Revise a preview-ready generation operation
curl --request POST \
  --url https://api.mint.gg/v1/operations/{operationId}:revise \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "feedback": "<string>"
}
'
{
  "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>"
  },
  "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"
}

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.

Authorizations

​
Authorization
string
header
required

Mint API key sent as a Bearer token.

Headers

​
Idempotency-Key
string
required

Unique key for safely retrying a mutating API request. Reusing a key with different parameters returns 409.

Required string length: 1 - 255

Path Parameters

​
operationId
string
required

Body

application/json
​
feedback
string
required

Revision instruction for the current preview.

Required string length: 1 - 2000

Response

Long-running generation operation accepted. Poll the Location URL for status.

​
object
any
required
​
id
string
required
​
type
enum<string>
required
Available options:
world_generation,
model_generation
​
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.

​
generationPreset
enum<string> | null
required

Mint generation tier selected for this operation.

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

Resolved final generation model selected by the generationPreset.

​
resource
object
required
​
mintUrl
string<uri> | null
required

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

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