---
title: "Import or upload a CAD file into Onshape, and translate the data into parts or assemblies."
method: POST
path: "/translations/d/{did}/w/{wid}"
tags: ["Translation"]
---

# Import or upload a CAD file into Onshape, and translate the data into parts or assemblies.

`POST /translations/d/{did}/w/{wid}`

## Request

- Base URL: `https://api.onshape.com/api/v17`
- URL: `https://api.onshape.com/api/v17/translations/d/{did}/w/{wid}`
- Auth: OAuth 2 and HTTP basic
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token` scopes: `OAuth2Read`

The API call may complete before the translation is finished. If `requestState = ACTIVE`, the translation can be polled until the state is either `DONE` or `FAILED`. Alternatively, a webhook callback can be registered for notification of translation completion (requires `Write` scope if `storeInDocument` is `true`). 
 
See [API Guide: Import & Export](https://onshape-public.github.io/docs/api-adv/translation/) for examples.

## Path parameters

- `did` string, required
- `wid` string, required

## Request body `multipart/form-data`

- BTBTranslationRequestParams
  - `allowFaultyParts` boolean
  - `createComposite` boolean
  - `createDrawingIfPossible` boolean
  - `encodedFilename` string
  - `extractAssemblyHierarchy` boolean
  - `file` string, binary: The file to upload.
  - `flattenAssemblies` boolean
  - `formatName` string
  - `importAppearances` boolean
  - `importMaterialDensity` boolean
  - `importWithinDocument` boolean
  - `joinAdjacentSurfaces` boolean
  - `locationElementId` string
  - `locationGroupId` string
  - `locationPosition` integer
  - `makePublic` boolean
  - `notifyUser` boolean
  - `onePartPerDoc` boolean
  - `ownerId` string
  - `parentId` string
  - `projectId` string
  - `repointAppElementVersionRefs` boolean
  - `splitAssembliesIntoMultipleDocuments` boolean
  - `storeInDocument` boolean
  - `translate` boolean
  - `unit` string
  - `uploadId` string
  - `useIGESImportPostProcessing` boolean
  - `versionString` string
  - `yAxisIsUp` boolean

## Response `default`

default response

---

[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)