Create a project
POST/projects
Creates a named project that groups parts in the Toolpath web UI. Name it after your internal quote number (or anything else) for tracking; duplicate names are allowed. Pass the returned id as projectId on POST /parts to upload new parts into this project. Optionally associate a default cut config via cutConfigId (404 if the id is unknown or owned by another team): parts uploaded into the project without explicit cutConfigIds auto-create their program with it instead of the API key creator’s default.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 429
- 500
Project created
Response Headers
Resource URL of the new project, for use with PUT /projects/{id} (v0 has no GET project endpoint). Sent on the first response only; idempotent replays return the same body without this header, so prefer data.id.
Invalid request
Missing or invalid bearer token
API key lacks the required scope for this action
Resource not found
Idempotency-Key collision (same key, different body)
Rate limit exceeded
Response Headers
Seconds to wait before retrying. Guaranteed on application-limited responses (POST /parts and POST /parts/{partId}/programs); may be absent on infrastructure-level 429s from other endpoints.
Unexpected server error