Create revision

POST

https://api.catenda.com/v2/projects/{project-id}/revisions

Upload a new model revision.

There are two ways to upload the IFC file:

Content-Type: application/ifc — the file is the entire request body and the upload parameters are sent in the Bimsync-Params header. Non-ASCII characters in filename and comment can be sent as raw UTF-8. Do not percent-encode individual field values: filename is percent-decoded on this route but comment is not, so a percent-encoded comment is stored as its encoded text, and a filename that genuinely contains a percent sign is altered.
Content-Type: multipart/form-data — the upload parameters are sent as a Bimsync-Params part and the file as a file part. Part bodies are read as UTF-8, so filenames and comments containing non-ASCII characters can be sent as they are, and a literal percent sign is left alone rather than decoded. Send the Bimsync-Params part before the file part — the upload is streamed rather than held in memory, so parameters that arrive after the file are rejected with a 400.

Note: The code examples for this method may have incorrect headers.

project-idstringCatenda project id

acceptstringGenerated from available response content types

Bimsync-ParamsobjectUpload parameters, as a JSON object. Required when uploading with Content-Type: application/ifc, <code>application/ifczip</code>, <code>application/ifcxml</code> or <code>application/octet-stream</code>. Non-ASCII characters in <code>filename</code> and <code>comment</code> can be sent as raw UTF-8. Do not percent-encode individual field values: <code>filename</code> is percent-decoded on this route but <code>comment</code> is not. To send a value containing a literal percent sign, pass the parameters in the request body instead by uploading with Content-Type: multipart/form-data.

Bimsync-Paramsobject

filestring<binary>The contents of the IFC file.

200OK

curl --request POST \
     --url https://api.catenda.com/v2/projects/{project-id}/revisions \
     --header 'accept: application/json' \
     --header 'content-type: application/ifc' \
     --header 'bimsync-params: {"comment":"string","filename":"string","model":"string"}' \
     --form 'Bimsync-Params="{\"comment\":\"string\",\"filename\":\"string\",\"model\":\"string\"}"' \
     --form 'file=@"/path/to/file"'