Start a model conversion operation

POST

models

{modelId}

:convert

curl --request POST \
  --url https://api.mint.gg/v1/models/{modelId}:convert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "targetFormats": [],
  "name": "<string>"
}
'

import requests

url = "https://api.mint.gg/v1/models/{modelId}:convert"

payload = {
    "targetFormats": [],
    "name": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({targetFormats: [], name: '<string>'})
};

fetch('https://api.mint.gg/v1/models/{modelId}:convert', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mint.gg/v1/models/{modelId}:convert",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'targetFormats' => [
        
    ],
    'name' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mint.gg/v1/models/{modelId}:convert"

	payload := strings.NewReader("{\n  \"targetFormats\": [],\n  \"name\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mint.gg/v1/models/{modelId}:convert")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"targetFormats\": [],\n  \"name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mint.gg/v1/models/{modelId}:convert")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"targetFormats\": [],\n  \"name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "object": "operation",
  "id": "op_01JEXAMPLE",
  "type": "model_conversion",
  "generationMode": "auto",
  "status": "running",
  "resource": {
    "type": "model",
    "id": "model_01JEXAMPLE"
  },
  "conversion": {
    "id": "conversion_01JEXAMPLE",
    "assets": null
  },
  "createdAt": "2026-07-21T20:00:00.000Z",
  "updatedAt": "2026-07-21T20:00:01.000Z"
}

{
  "object": "operation",
  "id": "op_01JEXAMPLE",
  "type": "model_conversion",
  "generationMode": "auto",
  "status": "running",
  "resource": {
    "type": "model",
    "id": "model_01JEXAMPLE"
  },
  "conversion": {
    "id": "conversion_01JEXAMPLE",
    "assets": null
  },
  "createdAt": "2026-07-21T20:00:00.000Z",
  "updatedAt": "2026-07-21T20:00:01.000Z"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

Authorizations

Authorization

string

header

required

Mint API key sent as a Bearer token.

Headers

Idempotency-Key

string

Optional stable key for safely retrying an uncertain mutating request. Mint creates an internal key when this header is omitted. Reusing a supplied key with different parameters returns 409.

Required string length: 1 - 255

Path Parameters

modelId

string

required

Mint 3D Model ID owned by the authenticated account.

Body

application/json

Choose the downloadable formats Mint should create from this 3D Model.

targetFormats

enum<string>[]

required

Output formats to create. Duplicate values are ignored.

Required array length: 1 - 5 elements

Available options:

glb,

obj,

stl,

usdz,

fbx

name

string

Optional title used for the conversion output and exported files.

Required string length: 1 - 120

Response

An earlier request with the same retry key returned this operation.

A long-running operation acting on one Mint model.

object

string

required

Stable object discriminator.

Allowed value: "operation"

string

required

Mint operation ID used for polling.

type

enum<string>

required

The work this operation performs.

Available options:

model_conversion

generationMode

enum<string>

required

Workflow mode for this operation.

Available options:

auto,

review

status

enum<string>

required

Current operation lifecycle status.

Available options:

queued,

running,

preview_ready,

billing_required,

succeeded,

partially_succeeded,

failed,

canceled

resource

object

required

The Mint model affected by this operation.

Show child attributes

createdAt

string<date-time>

required

When the operation was created.

updatedAt

string<date-time>

required

When the operation last changed.

conversion

object

Conversion job and its downloadable outputs.

Show child attributes

billing

object

The billing action required before this operation can continue.

Show child attributes

credits

object

Credit estimate, active reservation, finalized charge, and post-reservation balance for this operation.

Show child attributes

error

object

Terminal failure details when the operation failed.

Show child attributes

completedAt

string<date-time>

When the operation completed.

canceledAt

string<date-time>

When the operation was canceled.

List models owned by the accountList models owned by the account.

Start a model conversion operation

curl --request POST \
  --url https://api.mint.gg/v1/models/{modelId}:convert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "targetFormats": [],
  "name": "<string>"
}
'

import requests

url = "https://api.mint.gg/v1/models/{modelId}:convert"

payload = {
    "targetFormats": [],
    "name": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({targetFormats: [], name: '<string>'})
};

fetch('https://api.mint.gg/v1/models/{modelId}:convert', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mint.gg/v1/models/{modelId}:convert",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'targetFormats' => [
        
    ],
    'name' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mint.gg/v1/models/{modelId}:convert"

	payload := strings.NewReader("{\n  \"targetFormats\": [],\n  \"name\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mint.gg/v1/models/{modelId}:convert")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"targetFormats\": [],\n  \"name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mint.gg/v1/models/{modelId}:convert")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"targetFormats\": [],\n  \"name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "object": "operation",
  "id": "op_01JEXAMPLE",
  "type": "model_conversion",
  "generationMode": "auto",
  "status": "running",
  "resource": {
    "type": "model",
    "id": "model_01JEXAMPLE"
  },
  "conversion": {
    "id": "conversion_01JEXAMPLE",
    "assets": null
  },
  "createdAt": "2026-07-21T20:00:00.000Z",
  "updatedAt": "2026-07-21T20:00:01.000Z"
}

{
  "object": "operation",
  "id": "op_01JEXAMPLE",
  "type": "model_conversion",
  "generationMode": "auto",
  "status": "running",
  "resource": {
    "type": "model",
    "id": "model_01JEXAMPLE"
  },
  "conversion": {
    "id": "conversion_01JEXAMPLE",
    "assets": null
  },
  "createdAt": "2026-07-21T20:00:00.000Z",
  "updatedAt": "2026-07-21T20:00:01.000Z"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "operationId": "<string>",
  "billing": {
    "requiredCredits": 1,
    "actionUrl": "<string>",
    "availableCredits": 1,
    "committedCredits": 1,
    "stageCredits": 1,
    "completionCredits": 1
  }
}

Get Started

API References

API Guides

MCP

Agent Tooling

Start a model conversion operation

Authorizations

Headers

Path Parameters

Body

Response