Files and references

Route	What it does
GET /versions/:id/artifacts	The files of a draft or version
POST /versions/:id/artifacts?kind=	Upload, raw body, X-File-Name. Sources go into drafts only and queue a job
GET /versions/:id/artifacts/:kind/file	Download
DELETE /versions/:id/artifacts/:kind	Remove from a draft
GET /artifacts/:id, /artifacts/:id/file	A file by its id
POST /versions/:id/exports	Export an assembly: { format: "OFB" } or "STP". Runs as a job
GET /versions/:id/references	An assembly's references, resolved or pinned
GET /versions/:id/bom	The bill of material
GET /versions/:id/reference-updates, POST	Newer versions of what it uses; take them into the draft
GET /versions/:id/asm-json/resolved	The asm.json with references as addresses ClassCAD can load

The kinds of file are listed in Files and jobs.

References

An asm.json template points at a document like this:

{ "reference": { "location": "pdm://documents/ENG-1004@B" } }

Form	Means
pdm://documents/ENG-1004	The newest release, else the newest version
pdm://documents/ENG-1004@B	Revision B
pdm://documents/ENG-1004@v3	Version 3

The document can be named by its number or its id. How references resolve and get pinned is in Assemblies and references.