Kommo Upload API
The Upload API from Kommo — 1 operation(s) for upload.
The Upload API from Kommo — 1 operation(s) for upload.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/kommo:kommo-upload-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: files-api Upload API
version: '1.0'
servers:
- url: https://{your-drive}.kommo.com
variables:
your-drive:
default: your-drive
security:
- sec0: []
tags:
- name: Upload
paths:
/upload/{session_token}:
post:
summary: Upload a part of the file
description: 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.
operationId: upload-file
parameters:
- name: Content-Type
in: header
description: Request headers
schema:
type: string
default: application/json
- name: session_token
in: path
description: It is a part of upload_url that comes after "https://drive.kommo.com/upload/" that you get when you create an upload session
schema:
type: string
required: true
requestBody:
content:
application/json:
schema:
type: object
properties:
RAW_BODY:
type: string
format: binary
multipart/form-data:
schema:
type: object
properties:
RAW_BODY:
type: string
format: binary
responses:
'200':
description: '200'
content:
application/json:
examples:
Request successful (a part of the file was uploaded):
value: "{\n \"next_url\": \"https://drive-c.kommo.com/v1.0/sessions/upload/eyJhbGciOiJ362nj218I1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjc0MTg3MzYwMe82wiaWF0Ijo3NDE4NzM2MDAsIm5iZiI6NzQxODczNjAwLCJhY2NvdW50X2lkIjo3Nzc3Nzc3Nywic2Vzc2lvbl74837CI6Nzc3Nzc3NzcsInVzZXJfaWQiOjc3Nzc3NzcsInVzZXJfdHlwZSI6ImludGVybmFsIiwicGFydF9udW0iOjF9.8sdJVTZJ_MjuHhMGDkU7_eSi2q1u1EG-au_TZhmmXK8\",\n \"session_id\": 26434413\n}"
Request successful (the final part of the file was uploaded):
value: "{\n \"_links\": {\n \"download\": {\n \"href\": \"https://drive-c.kommo.com/download/aff5603a-gt68-4c17-8e98-16e473b323b3/367b9f38-5f01-4cea-947e-dfab47aea522/picture.png\"\n },\n \"download_version\": {\n \"href\": \"https://drive-c.kommo.com/download/aff5603a-h689-4c17-8e98-16e473b323b3/dnjcjrjee3f38-5f01-4cea-947e-dfab47aea522/43de3be7-307b-4766-a23e-5e88211b9a8d/picture.png\"\n },\n \"self\": {\n \"href\": \"https://drive-c.kommo.com/v1.0/files/367b9f38-273d-4cea-947e-df392u9daea522\"\n }\n },\n \"created_at\": 1671687247,\n \"created_by\": { \"type\": \"internal\", \"id\": 7758337 },\n \"deleted_at\": null,\n \"deleted_by\": null,\n \"has_multiple_versions\": false,\n \"is_trashed\": false,\n \"metadata\": { \"extension\": \"png\", \"mime_type\": \"image/png\" },\n \"name\": \"product\",\n \"previews\": null,\n \"sanitized_name\": \"product\",\n \"session_id\": 26136001,\n \"size\": 7526,\n \"source_id\": null,\n \"type\": \"file\",\n \"updated_at\": 1671687247,\n \"updated_by\": { \"type\": \"internal\", \"id\": 7758337 },\n \"uuid\": \"367b9f38-5f01-4cea-947e-dfab3672678522\",\n \"version_uuid\": \"43de3be7-307b-4766-a23ekc-cdks1b9a8d\"\n}"
schema:
oneOf:
- title: Request successful (a part of the file was uploaded)
type: object
properties:
next_url:
type: string
example: https://drive-c.kommo.com/v1.0/sessions/upload/eyJhbGciOiJ362nj218I1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjc0MTg3MzYwMe82wiaWF0Ijo3NDE4NzM2MDAsIm5iZiI6NzQxODczNjAwLCJhY2NvdW50X2lkIjo3Nzc3Nzc3Nywic2Vzc2lvbl74837CI6Nzc3Nzc3NzcsInVzZXJfaWQiOjc3Nzc3NzcsInVzZXJfdHlwZSI6ImludGVybmFsIiwicGFydF9udW0iOjF9.8sdJVTZJ_MjuHhMGDkU7_eSi2q1u1EG-au_TZhmmXK8
session_id:
type: integer
example: 26434413
default: 0
- title: Request successful (the final part of the file was uploaded)
type: object
properties:
_links:
type: object
properties:
download:
type: object
properties:
href:
type: string
example: https://drive-c.kommo.com/download/aff5603a-gt68-4c17-8e98-16e473b323b3/367b9f38-5f01-4cea-947e-dfab47aea522/picture.png
download_version:
type: object
properties:
href:
type: string
example: https://drive-c.kommo.com/download/aff5603a-h689-4c17-8e98-16e473b323b3/dnjcjrjee3f38-5f01-4cea-947e-dfab47aea522/43de3be7-307b-4766-a23e-5e88211b9a8d/picture.png
self:
type: object
properties:
href:
type: string
example: https://drive-c.kommo.com/v1.0/files/367b9f38-273d-4cea-947e-df392u9daea522
created_at:
type: integer
example: 1671687247
default: 0
created_by:
type: object
properties:
type:
type: string
example: internal
id:
type: integer
example: 7758337
default: 0
deleted_at: {}
deleted_by: {}
has_multiple_versions:
type: boolean
example: false
default: true
is_trashed:
type: boolean
example: false
default: true
metadata:
type: object
properties:
extension:
type: string
example: png
mime_type:
type: string
example: image/png
name:
type: string
example: product
previews: {}
sanitized_name:
type: string
example: product
session_id:
type: integer
example: 26136001
default: 0
size:
type: integer
example: 7526
default: 0
source_id: {}
type:
type: string
example: file
updated_at:
type: integer
example: 1671687247
default: 0
updated_by:
type: object
properties:
type:
type: string
example: internal
id:
type: integer
example: 7758337
default: 0
uuid:
type: string
example: 367b9f38-5f01-4cea-947e-dfab3672678522
version_uuid:
type: string
example: 43de3be7-307b-4766-a23ekc-cdks1b9a8d
'400':
description: '400'
content:
application/json:
examples:
Incorrect data transmitted:
value: '{}'
schema:
type: object
properties: {}
'401':
description: '401'
content:
text/plain:
examples:
Authentication failed:
value: ''
'403':
description: '403'
content:
text/plain:
examples:
You do not have rights to call this method:
value: ''
deprecated: false
tags:
- Upload
components:
securitySchemes:
sec0:
type: oauth2
flows: {}
x-readme-fauxas: true
x-provenance:
method: searched
source: https://developers.kommo.com/reference
harvested: '2026-11-15'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://developers.kommo.com/reference/create-session.md
- https://developers.kommo.com/reference/delete-files.md
- https://developers.kommo.com/reference/edit-file.md
- https://developers.kommo.com/reference/file-uuid.md
- https://developers.kommo.com/reference/get-files.md
- https://developers.kommo.com/reference/get-version.md
- https://developers.kommo.com/reference/restore-files.md
- https://developers.kommo.com/reference/upload-file.md
- https://es-developers.kommo.com/reference/adjuntar-archivos-a-entidad.md
- https://es-developers.kommo.com/reference/cargar-parte-del-archivo.md
- https://es-developers.kommo.com/reference/desvincular-archivos-de-entidad.md
- https://es-developers.kommo.com/reference/editar-un-archivo.md
- https://es-developers.kommo.com/reference/eliminar-archivos.md
- https://es-developers.kommo.com/reference/obtener-archivo-por-uuid.md
- https://es-developers.kommo.com/reference/obtener-archivos-adjuntos-a-entidad.md
- https://es-developers.kommo.com/reference/obtener-entidades-asociadas-a-archivo.md
- https://es-developers.kommo.com/reference/obtener-lista-de-archivos.md
- https://es-developers.kommo.com/reference/restaurar-archivos.md
- https://pt-developers.kommo.com/reference/anexar-arquivos-a-uma-entidade.md
- https://pt-developers.kommo.com/reference/carregar-uma-parte-do-arquivo.md
- https://pt-developers.kommo.com/reference/desanexar-arquivos-de-uma-entidade.md
- https://pt-developers.kommo.com/reference/editar-um-arquivo.md
- https://pt-developers.kommo.com/reference/excluir-arquivos.md
- https://pt-developers.kommo.com/reference/obter-arquivos-anexados-a-uma-entidade.md
- https://pt-developers.kommo.com/reference/obter-entidades-associadas-a-um-arquivo.md
- https://pt-developers.kommo.com/reference/obter-um-arquivo-por-uuid.md
- https://pt-developers.kommo.com/reference/obter-uma-lista-de-arquivos.md
- https://pt-developers.kommo.com/reference/restore-files.md
merge:
pages: 28
deduped: 27
conflicts_kept_first: 16