Create revision
POST
https://api.catenda.com/v2/projects/{project-id}/libraries/{library-id}/items/{library-item-id}/revisions
Path Parameters
- project-idstringrequiredExampleDescription
- library-idstringrequiredDescription
- library-item-idstringrequiredDescription
Header Parameters
- Bimsync-Paramslibrary-item-revision-upload-paramsDescription
- namestringrequiredExampleDescription
Form Parameters
- Bimsync-Paramslibrary-item-revision-upload-paramsrequired
- namestringrequiredExampleDescription
- filestring<binary>requiredDescriptionFormatbinary
Responses
200
- library-item-document-file-revision
- idstringExampleDescription
- parentIdstringDescription
- versionnumberExampleDescription
- extendedVersionobjectDescription
- majornumberExampleDescription
- minorstringExampleDescription
- namestringExampleDescription
- createdAtstringExampleDescription
- sizenumberExampleDescription
- createdByuserDescription
- idstringExampleDescription
- namestringExampleDescription
- usernamestringExampleDescription
- emailstringExampleDescription
- createdAtstringExampleDescription
- avatarUrlstringExampleDescription
- typestring<user | organization | team>ExampleDescriptionAlloweduserorganizationteam
- additionalFormatsobject[]Description
- sizenumberExampleDescription
- mediaTypestringExampleDescription
- downloadFileNamestringExampleDescription
curl
curl --request POST \
--url https://api.catenda.com/v2/projects/{project-id}/libraries/{library-id}/items/{library-item-id}/revisions \
--header 'accept: application/json' \
--header 'content-type: application/octet-stream' \
--header 'bimsync-params: {"name":"string"}' \
--form 'Bimsync-Params="{\"name\":\"string\"}"' \
--form 'file=@"/path/to/file"'javascript
var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/octet-stream");
myHeaders.append("bimsync-params", "{\"name\":\"string\"}");
var formdata = new FormData();
formdata.append("Bimsync-Params", "{\"name\":\"string\"}");
formdata.append("file", fileInput.files[0], "file");
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: formdata,
redirect: 'follow'
};
fetch("https://api.catenda.com/v2/projects/{project-id}/libraries/{library-id}/items/{library-item-id}/revisions", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));ruby
require "uri"
require "net/http"
url = URI("https://api.catenda.com/v2/projects/{project-id}/libraries/{library-id}/items/{library-item-id}/revisions")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/octet-stream"
request["bimsync-params"] = "{\"name\":\"string\"}"
form_data = [['Bimsync-Params', File.open('undefined')],['file', File.open('/path/to/file')]]
request.set_form form_data, 'multipart/form-data'
response = https.request(request)
puts response.read_body
python
import requests
url = "https://api.catenda.com/v2/projects/{project-id}/libraries/{library-id}/items/{library-item-id}/revisions"
payload = {}
files=[
('file',('file',open('/path/to/file','rb'),'application/octet-stream'))
]
headers = {
'accept': 'application/json',
'content-type': 'application/octet-stream',
'bimsync-params': '{"name":"string"}'
}
response = requests.request("POST", url, headers=headers, data=payload, files=files)
print(response.text)
200
// OK
{
"id": "h4c21c0e89774c8e92f42959c73561yh",
"parentId": "",
"version": 9,
"extendedVersion": {
"major": 1,
"minor": 1
},
"name": "File.txt",
"createdAt": "2023-03-01T11:52:45.000Z",
"size": 3745,
"createdBy": {
"id": "524809076a694255b989d236517a55da",
"name": "John Doe",
"username": "[email protected]",
"email": "[email protected]",
"createdAt": "2016-09-20T14:55:22.000Z",
"avatarUrl": "https://api.catenda.com/v2/avatar/397t0ccd8f74516096c738de15dc6512",
"type": "user"
},
"additionalFormats": [
{
"size": 7147,
"mediaType": "application/xod"
}
],
"downloadFileName": "File-1.txt"
}