---
title: "Abort an upload session (redact)"
method: DELETE
path: "/vaults/v1/{vault_id}/upload-sessions/{upload_session_id}"
tags: ["vault"]
---

# Abort an upload session (redact)

`DELETE /vaults/v1/{vault_id}/upload-sessions/{upload_session_id}`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/vaults/v1/{vault_id}/upload-sessions/{upload_session_id}`
- Auth: one of:
  - API key in header `SIGN-IN-WITH-X`
  - HTTP bearer
  - HTTP bearer

Abort is REDACTION: the session stops being finalizable, its reservation is released, and every object already stored under it is tombstoned so the reaper removes the bytes. Idempotent. A finalized session cannot be aborted.

## Path parameters

- `vault_id` string, required
- `upload_session_id` string, required

## Headers

- `SIGN-IN-WITH-X` string, required

## Response `200`

Session aborted

- object
  - `upload_session_id` string, uuid
  - `state` 'aborted'
  - `tombstoned_objects` integer
  - `deduplicated` boolean

## Other responses

- `400`: VALIDATION_FAILED — the session is already finalized
- `403`: Not authorized (VAULT_ACCESS_DENIED)
- `404`: No such session on this vault

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)