Create item

POST

https://api.catenda.com/v2/projects/{project-id}/libraries/{library-id}/items

Add a new library item.

Supported library types are document, link and classification.

For file upload, only document library type is supported. There are two ways to upload a file:

Content-Type: application/octet-stream — the file is the request body and the parameters go in the Bimsync-Params header. Header values are limited to ISO-8859-1, so non-ASCII characters in document.filename must be percent-encoded, and name cannot carry them at all.
Content-Type: multipart/form-data — the parameters go in a Bimsync-Params part and the file in a file part. Part bodies are read as UTF-8, so non-ASCII filenames are sent as they are and a literal percent sign is left alone. Send the Bimsync-Params part before the file part — the upload is streamed, so parameters arriving after the file are rejected with a 400.

project-idstringCatenda project id

library-idstringId of the library

acceptstringGenerated from available response content types

Bimsync-ParamsobjectUpload parameters, as a JSON object. Required with Content-Type: application/octet-stream. Percent-encode any non-ASCII characters in <code>document.filename</code>; <code>name</code> is not percent-decoded, so a non-ASCII name can only be sent via the request body with Content-Type: multipart/form-data.

bodyobject

200OK

curl --request POST \
     --url https://api.catenda.com/v2/projects/{project-id}/libraries/{library-id}/items \
     --header 'accept: application/json' \
     --header 'bimsync-params: {"name":"string","document":{}}'