Skip to main content

Create a part

POST 
/parts

Creates a pending part and returns a short-lived presigned URL for uploading its CAD file directly to S3. Supported formats include STEP, IGES, Parasolid, SolidWorks, CATIA, and NX part files; see the fileName field for the full extension list.

Upload flow:

  1. POST /parts to create the part and get upload.url.
  2. PUT the raw part file bytes to upload.url.
  3. POST /parts/{id}/complete to start processing.

Then poll GET /parts/{id} until status transitions from processing to ready; the ready response carries currentProgramId (the selected auto-created program). A program is auto-created by default. Its cut config is resolved in order: the cutConfigIds you pass (one program per listed cut config); otherwise the default cut config of the project referenced by projectId, when it has one; otherwise the API key creator’s default cut config. Pass autoCreateProgram: false to skip program creation (the part still becomes ready, with currentProgramId null) and create one program yourself via POST /parts/{partId}/programs.

Rate limited to 30 part creations per minute per team, paced at one every 2 seconds. Exceeding the limit returns 429 with a Retry-After header.

Request​

Responses​

Part created. PUT the part file to upload.url, then call POST /parts/{id}/complete.

Response Headers
    Location

    URL for polling the new part. Sent on the first response only; idempotent replays return the same body without this header, so prefer data.id.