Для AI-агентов: markdown этой страницы — /docs-content/storage/upload/multipart-abort.md индекс документации — /llms.txt

Отменить составную загрузку

POST /v1/storage/objects/multipart/abort

Отменяет незавершённую сессию составной загрузки и освобождает загруженные части. Для первой загрузки запись PENDING удаляется. При замене существующий объект и его прежнее содержимое сохраняются, очищаются только поля сессии. Состояние сессии очищается только после успешной отмены или ответа хранилища, что указанный uploadId уже отсутствует. При таймауте, 5xx, throttling или неизвестной ошибке abort сервер сохраняет сессию для повтора и возвращает 502 STORAGE_BUCKET_ERROR. Если сессией уже владеет финализация, abort возвращает 409 STORAGE_KEY_CONFLICT: повторите complete с теми же parts; зажурналированный ответ завершится локально, а неподтверждённый исход требует операторской сверки. Отменённые части восстановить невозможно.

Поля запроса (body)

Тело запроса — JSON.

Параметр	Тип	Обяз.	По умолч.	Описание
`objectId`	string	да	—	Идентификатор объекта, полученный из ответа `/multipart/create`

Примеры

curl — личный ключ

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/storage/objects/multipart/abort \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"objectId": "cmpfg012a01aco510mrr6u632"}'

curl — OAuth-приложение

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/storage/objects/multipart/abort \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"objectId": "cmpfg012a01aco510mrr6u632"}'

JavaScript — личный ключ

javascript

const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/storage/objects/multipart/abort',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ objectId: 'cmpfg012a01aco510mrr6u632' }),
  }
)
const { aborted } = await res.json()
console.log('Aborted:', aborted) // true

JavaScript — OAuth-приложение

javascript

const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/storage/objects/multipart/abort',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ objectId: 'cmpfg012a01aco510mrr6u632' }),
  }
)
const { aborted } = await res.json()

Поля ответа

Поле	Тип	Описание
`aborted`	boolean	`true` при успешной отмене

Пример ответа

JSON

{
  "aborted": true
}

Пример ответа при ошибке

404 — объект не найден или сессия уже завершена: