--- title: "Export the assembly to another format." method: POST path: "/assemblies/d/{did}/{wv}/{wvid}/e/{eid}/translations" tags: ["Assembly"] --- # Export the assembly to another format. `POST /assemblies/d/{did}/{wv}/{wvid}/e/{eid}/translations` ## Request - Base URL: `https://api.onshape.com/api/v17` - URL: `https://api.onshape.com/api/v17/assemblies/d/{did}/{wv}/{wvid}/e/{eid}/translations` - Auth: OAuth 2 and HTTP basic - Authorization code: `/oauth/authorize` - Token URL: `/oauth/token` scopes: `OAuth2Read` Creates an asynchronous export. Use format-specific export endpoints where available. * Use `formatName` in the JSON request body to specify the export file type. Use [Translations/getAllTranslatorFormats](#/Translation/getAllTranslatorFormats) to get a list of valid export file formats. Confirm that `couldBeAssembly=true.` * Set `storeInDocument` to `false` to export to a data file. Set to `true` to export to a blob element in the same document. * See [API Guide: Import & Export ](https://onshape-public.github.io/docs/api-adv/translation/#export-an-assembly-to-another-format) for more details. ## Path parameters - `did` string, required - `wv` string, required - `wvid` string, required - `eid` string, required ## Request body - BTTranslateFormatParams - `allowFaultyParts` boolean: If true, parts with faults are imported. If false, faulty parts are omitted. - `angularTolerance` number, double: Determines the maximum angular deviation, between the analytical surface and its triangulation. Lower values result in a finer geometry and higher values result in coarser geometry. - `annotationsFontHeightInMillimeters` number, double: Determines the font size in workspace units used for the MBD annotations text export - `blobElementId` string - `blobMicroversionId` string - `cloudObjectId` string: Folder id where to store the exported model. - `cloudStorageAccountId` string: Account id to access the cloud storage. - `colorMethod` string - `configuration` string: URL-encoded string of configuration values (separated by `;`). See the [Configurations API Guide](https://onshape-public.github.io/docs/api-adv/configs/) for details. - `connectionId` string - `correlationId` string: User specified identifier that can be used as a correlation id across api calls. - `createComposite` boolean - `currentSheetOnly` boolean - `destinationName` string: The name of the exported file. - `distanceTolerance` number, double: Determines the maximum distance deviation, between the analytical surface and its triangulation. Lower values result in a finer geometry and higher values result in coarser geometry. - `dxfVersion` string - `elementId` string: The id of the element in which to perform the operation. - `elementIds` string[]: An array of element ids for multi-element export. - `emailLink` boolean: Use `true` if a link in an email should be sent. - `emailMessage` string: Message to send in the email body along with the download link. - `emailSubject` string: Subject to send the email with. - `emailTo` string[]: List of email addresses to send the email to. - `evaluateExportRule` boolean: Set to `true` to evaluate the export rule for the given `formatName` and to include an `exportRuleFileName` value in the response. - `excludeHiddenEntities` boolean: Whether or not to exclude hidden parts from export. - `excludeOffSheetContent` boolean - `exportCompositeConstituentsWithOriginalBodyIds` boolean - `extractAssemblyHierarchy` boolean - `flatPatternAsync` boolean - `flatten` boolean - `flattenAssemblies` boolean - `foreignId` string - `formatName` string, required: The name of the file format. - `fromUserId` string: Id of the user who does the export. - `getyAxisIsUp` boolean - `grouping` boolean: Whether parts should be exported as a group or individually in a .zip file. - `hideInspectionItems` boolean - `ignoreExportRulesForContents` boolean: For multiple elements export, use `true` if export rule shouldn't be applied for all elements. - `imageHeight` integer - `imageWidth` integer - `importAppearances` boolean - `importInBackground` boolean - `importMaterialDensity` boolean - `importWithinDocument` boolean - `includeBendCenterlines` boolean - `includeBendLines` boolean - `includeCboreCsink` boolean - `includeDerivedTolerances` boolean - `includeExportIds` boolean: Whether topology ids should be exported as parasolid attributes. - `includeFormedCentermarks` boolean - `includeFormedOutlines` boolean - `includeSketches` boolean - `joinAdjacentSurfaces` boolean - `level` string - `linkDocumentId` string: The id of the document through which the above document should be accessed; only applicable when accessing a version of the document. This allows a user who has access to document a to see data from document b, as long as document b has been linked to document a by a user who has permission to both. - `linkDocumentWorkspaceId` string: The id of the workspace through which the above document should be accessed; only applicable when accessing a version of the document. This allows a user who has access to document a to see data from document b, as long as document b has been linked to document a by a user who has permission to both. - `maximumChordLength` number, double: Determines the maximum of a triangle edge length. Lower values result in a finer geometry and higher values result in coarser geometry. - `notifyUser` boolean: Send notification to the user client. - `occurrencesToExport` string: IDs of the occurrences to retrieve. Use comma-separated IDs for multiple instances (example: occurrencesToExport=JHK,JHD). - `onePartPerDoc` boolean - `originalForeignId` string - `parasolidMode` 'TEXT' | 'BINARY' | 'UNKNOWN': Export Parasolid in `BINARY` (.x_b) or `TEXT` (.x_t) mode. - `parentId` string - `partIds` string: IDs of the parts to retrieve. Use comma-separated IDs for multiple parts (example: partIds=JHK,JHD). - `partsExportFilter` BTPartsExportFilter4308: Skip mesh/curve foreign data creation in individual parts export - `btType` string: Type of JSON object. - `skipAllMesh` boolean - `skipCurves` boolean - `skipPartialMesh` boolean - `password` string: A password to protect the email with. - `passwordRequired` boolean: Use `true` if the email should be protected with a password. - `pdfVersion` string - `processedForeignId` string - `projectId` string - `proxyDocumentId` string - `proxyElementId` string - `proxyWorkspaceVersion` string - `proxyWorkspaceVersionId` string - `resolution` 'fine' | 'medium' | 'coarse': Determines export resolution of fine, medium, or coarse - `rhinoVersion` 'V2' | 'V3' | 'V4' | 'V5' | 'V6' | 'V7' | 'V8' | 'UNKNOWN' - `selectablePdfText` boolean - `sendCopyToMe` boolean: Use `true` if email copy should be sent to the user who does the export. - `sheetIndices` integer[] - `sheetMetalFlat` boolean - `showOverriddenDimensions` boolean - `skipBodyshop` boolean - `sourceName` string - `specifyMaterialData` boolean - `specifyUnits` boolean - `splinesAsPolylines` boolean - `splitAssembliesIntoMultipleDocuments` boolean - `stepParasolidPreprocessingOption` 'NO_PRE_PROCESSING' | 'USE_BODYSHOP_PRE_PROCESSING_ADVANCED' | 'USE_TRANSLATOR_PRE_PROCESSING' | 'USE_BODYSHOP_PRE_PROCESSING' | 'USE_BODYSHOP_PRE_PROCESSING_ADVANCED_WITH_SURFS_TO_BSURFS_CONVERTING' | 'UNKNOWN': Original geometry processing mode to improve results of translation to STEP. - `stepVersionString` string: Export STEP in version: `AP242` | `AP203` | `AP214` - `stlMode` 'TEXT' | 'BINARY' | 'UNKNOWN': STL encoding type, `TEXT | BINARY` - `storeInDocument` boolean: Create a blob with exported file in the source document. - `textAsGeometry` boolean - `textOption` string - `triggerAutoDownload` boolean: Automatically download a translated file. - `unit` string - `uploadId` string - `urdfMeshFormat` 'STL' | 'GLTF' | 'OBJ' | 'GLB' | 'UNKNOWN' - `urdfStlEncoding` 'TEXT' | 'BINARY' | 'UNKNOWN': STL encoding type, `TEXT | BINARY` - `useFileNameToSetSinglePartName` boolean - `useGlbCompression` boolean - `useGltfCompression` boolean - `useIGESImportPostProcessing` boolean - `useIgesCompatibilityMode` boolean - `validForDays` integer: Number of days to keep the link valid for. - `versionString` string: Parasolid version number as string. Use '0' for the latest. ## Response `default` default response ## Changes - **2026-08-29** `5fa7a57a26dd`: 2 info - added the new optional request property `exportCompositeConstituentsWithOriginalBodyIds` - added the new `GLB` enum value to the request property `urdfMeshFormat` [Operation history](https://skmtc.dev/onshape/apis/onshape-rest-api/changes/assemblies/d/:did/:wv/:wvid/e/:eid/translations/post.md) --- [API](https://skmtc.dev/onshape/apis/onshape-rest-api.md) - [All operations](https://skmtc.dev/onshape/apis/onshape-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onshape/apis/onshape-rest-api/revisions/c5c4c780f831?raw)