post https://{your-drive}.kommo.com/upload/
The method allows you to upload part of the file. The request must be sent to the file service host. The full link indicating the session_token is returned when the session is opened.
Unfortunately, you won't be able to upload a file via this page. Please, choose a different tool.
Not sure what your drive name is?
Read a short article to find out.
What is a session_token?
You create an upload session and get a response:
{
"max_file_size": 314572800,
"max_part_size": 131072,
"session_id": 106687453,
"upload_url": "https://drive-c.kommo.com/upload/eyJhbGciOiJIU...w6E6F5DCU0"
}
eyJhbGciOiJIU...w6E6F5DCU0
is your session_token
.
Limitations
The method is available to integrations that have scope set to Access to files.
Data type header when the request is successful/ in case of an error
Content-Type: application/json
Response parameters (NOT the final part of the file)
Parameter | Data type | Description |
---|---|---|
session_id | int | Session ID |
next_url | string | URL that should be used to upload the next part of the file |
Response parameters (the final part of the file)
Parameter | Data type | Description |
---|---|---|
uuid | string | UUID of a file version |
type | string | File version type. Possible parameters– image, video, audio, document, file |
name | string | File version name |
sanitized_name | string | File version name in ASCII encoding |
size | int | File version size in bytes |
source_id | int|null | ID of the source the file version came from |
has_multiple_versions | bool | Tells if the file has multiple versions |
created_at | int | Unix Timestamp file version creation time |
created_by | object | ID of a user added the file version |
created_by[id] | int | ID of the user who added the file version |
created_by[type] | string | Type of user who added the file version |
updated_at | int | Time when the file version was last updated (Unix Timestamp) |
updated_by | object | ID of the user who updated the file version |
deleted_at | int | Time when the file version was deleted (Unix Timestamp) |
deleletd_by | object | ID of the user who deleted the file version |
metadata | object|null | File metadata |
metadata[extension] | string | File extention |
metadata[mime_type] | string | File MIME-type |
previews | array|null | Array of previews for the file |
previews[0] | object | File preview |
previews[0][download_link] | string | URL to download preview |
previews[0][width] | int | Preview width |
previews[0][height] | int | Preview height |