Upload a file
POST/v1/files
Creates a CAD file and returns a short-lived URL for uploading it. Use a file rather than Upload a part when the file may hold more than one solid body — a part beside its stock, or several parts: upload it to the URL, run Inspect a file (PATCH /v1/files/{id}) to list its bodies, then Make parts from a file (POST /v1/files/{id}/parts). A file is one upload: uploading again once inspection has been asked for is not supported, even of the same file, and the next request may be refused with file_source_changed. Create a new file for a new upload.
Experimental. Available now and still gaining functionality. It may change in breaking ways in a minor API release; each such change is listed in the release notes, so check them before upgrading.
Request
Responses
- 201
- 400
- 401
- 403
- 500
- 503
The file was created and is ready for direct upload.
The request is invalid, or the filename names no reader.
The API key is missing or invalid.
The API key may not perform this operation: it has no access to this part of the API, it may only read it, or its creator has not met the organization’s two-factor requirement.
The file could not be created.
Authentication is temporarily unavailable.