---
title: "Upload a file to a managed case"
method: POST
path: "/managed-cases/{id}/files"
tags: ["ManagedCases"]
---

# Upload a file to a managed case

`POST /managed-cases/{id}/files`

Uploads one ordinary case document to a case you submitted as managing partner.

**Access:** The authenticated partner must match the case's managing partner. This is separate from the collecting-partner upload route.

**Status gate:** Allowed on every lifecycle except Merged, including Closed.

**File requirements:** Maximum 25 MB. Allowed filename extensions are `.pdf` `.doc` `.docx` `.xls` `.xlsx` `.jpg` `.jpeg` `.png` `.txt` `.zip` `.csv` `.eml`.

**Optional fields:** `DocumentType` accepts OriginalInvoice, DebtorDocuments, CreditorDocuments, PartnerDocuments, DemandLetter, or Miscellaneous (case-insensitive). `Description` is limited to 500 characters.

Use `Idempotency-Key` to retry safely. An identical replay returns the original response. Separate uploads with the same filename are stored independently and cannot overwrite one another.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Response `200`

File uploaded successfully

- DebituraWebExternalApiContractsV1FilesCaseFileDto
  - `id` string, uuid
  - `dateCreated` string, date-time
  - `dateUpdated` string, date-time
  - `caseId` string, uuid
  - `entityType` string, nullable
  - `entityId` string, uuid
  - `fileName` string, nullable
  - `url` string, nullable
  - `description` string, nullable
  - `documentType` string, nullable

## Other responses

- `400` — Missing file or invalid request
- `404` — Case not found or not managed by this partner
- `409` — Case is merged or idempotent request is in progress
- `413` — File exceeds 25 MB
- `415` — Unsupported file extension
- `422` — Idempotency-Key reused with a different request
- `500` — Internal server error

---

[API](https://skmtc.net/debitura/apis/debitura-collection-partner-api.md) · [All operations](https://skmtc.net/debitura/apis/debitura-collection-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debitura/debitura-collection-partner-api/revisions/db09d0fd5c94/schema)