---
updatedAt: 2026-06-15T03:55:14.000Z
agentTools:
  projectIndex: https://developer.threekit.com/llms.txt
---

# Export an Asset

Exports an asset or a product. To export a product, replace asset ID with the product ID in the url.

Supported export 3D filetypes include .dxf, .fbx, .gltf, .usdz, .step, .stl

Supported export image filetypes include .svg


# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Assets & Catalog - Import, Export, and Render Jobs",
    "version": "1.1.0"
  },
  "servers": [
    {
      "url": "https://preview.threekit.com/api"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "paths": {
    "/asset-jobs/{assetId}/export/{format}": {
      "post": {
        "operationId": "exportAsset",
        "tags": [
          "Asset Jobs - Import, Export, Render, etc."
        ],
        "summary": "Export an Asset",
        "description": "Exports an asset or a product. To export a product, replace asset ID with the product ID in the url.\n\nSupported export 3D filetypes include .dxf, .fbx, .gltf, .usdz, .step, .stl\n\nSupported export image filetypes include .svg\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/cacheParameter"
          },
          {
            "$ref": "#/components/parameters/waitParameter"
          },
          {
            "$ref": "#/components/parameters/assetIdParameter"
          },
          {
            "$ref": "#/components/parameters/exportFormatParameter"
          },
          {
            "$ref": "#/components/parameters/publicTokenParameter"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Export information.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/exportBody"
              }
            }
          }
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/assetExport200"
          },
          "401": {
            "$ref": "#/components/responses/unauthorized401"
          },
          "422": {
            "$ref": "#/components/responses/assetExport422"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Private access token used to authorize the request."
      }
    },
    "schemas": {
      "exportBody": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "required": [
              "true"
            ],
            "description": "Filename to save the export as."
          },
          "orgId": {
            "type": "string",
            "required": [
              "true"
            ],
            "description": "Organization which owns the asset or product to export."
          },
          "configuration": {
            "type": "object",
            "required": [
              "true"
            ],
            "description": "Configuration information. Attribute keys with valid attribute option values."
          },
          "sync": {
            "type": "boolean",
            "required": [
              "false"
            ],
            "description": "If the request has the sync option set, it will wait for the job to finish and then return\nthe results (jobId and job details). Otherwise it will return only the jobId.\n"
          }
        }
      }
    },
    "parameters": {
      "publicTokenParameter": {
        "in": "query",
        "name": "bearer_token",
        "description": "Public access token used to authorize the request. Requests may only come from the token's allowed domains. **This parameter is mandatory when making requests from a browser. Outside of the browser instead supply a bearer header using a private access token**.",
        "required": false,
        "schema": {
          "type": "string"
        },
        "example": "edccd9d2-0141-4186-8872-f163f1e2063b"
      },
      "assetIdParameter": {
        "in": "path",
        "name": "assetId",
        "schema": {
          "type": "string"
        },
        "description": "AssetID",
        "required": true
      },
      "exportFormatParameter": {
        "in": "path",
        "name": "format",
        "schema": {
          "type": "string"
        },
        "description": "Format to export",
        "required": true
      },
      "cacheParameter": {
        "in": "query",
        "name": "cache",
        "description": "Caches the file created.",
        "required": false,
        "schema": {
          "type": "boolean"
        },
        "example": "cache=true"
      },
      "waitParameter": {
        "in": "query",
        "name": "wait",
        "description": "It will query for the latest version of the file. If the latest version is not available,\nit will serve an older version and queue a job for the new one. If no version is available,\nit will create one and send it back in the response. This parameter will only work in\nconjunction with the cache parameter. It has no effect if the cache parameter is not present\nin the request.\n",
        "required": false,
        "schema": {
          "type": "boolean"
        },
        "example": "wait=true"
      }
    },
    "responses": {
      "unauthorized401": {
        "description": "Unauthorized to make the request.",
        "content": {
          "application/json": {
            "examples": {
              "Unauthorized": {
                "summary": "Unauthorized to make the request",
                "value": {
                  "error": {
                    "type": "unauthorized",
                    "message": "unauthorized"
                  }
                }
              }
            }
          }
        }
      },
      "assetExport200": {
        "description": "Asset export job was started.",
        "content": {
          "application/json": {
            "examples": {
              "exportedAsset": {
                "summary": "An example of a successfully started export job",
                "value": {
                  "msg": "export started",
                  "jobId": "22401a9e-fa86-11e9-8234-ebb42336687b",
                  "job": {
                    "id": "22401a9e-fa86-11e9-8234-ebb42336687b",
                    "createdBy": "c87b4f24-fa85-11e9-b80e-bbd116e35040",
                    "orgId": "c87b4f24-fa85-11e9-b80e-bbd116e35040",
                    "title": "ExportedFile.fbx",
                    "schedulerState": "active",
                    "type": "export",
                    "createdAt": "2019-10-29T18:59:23.715Z",
                    "updatedAt": "2019-10-29T18:59:23.715Z",
                    "priority": 0,
                    "tasks": [
                      {
                        "title": "ExportedFile.fbx",
                        "type": "export",
                        "jobId": "22401a9e-fa86-11e9-8234-ebb42336687b",
                        "id": "024905d2-80d5-4384-978c-1e04e75ce720"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "assetExport422": {
        "description": "Malformed request, export job couldn't start.",
        "content": {
          "application/json": {
            "example": {
              "exportFailure": {
                "summary": "Export job could not be created",
                "value": {
                  "error": {
                    "type": "export_failure",
                    "message": "failed to create job"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```