---
title: "Upload a file to a case. Optionally posts a system chat message to notify the collection partner."
method: POST
path: "/cases/{caseId}/files"
tags: ["Cases"]
---

# Upload a file to a case. Optionally posts a system chat message to notify the collection partner.

`POST /cases/{caseId}/files`

Uploads a file and associates it with a case owned by one of the referral partner's clients.

File requirements:
- Maximum file size: 25 MB
- Allowed types: PDF, Excel (.xls, .xlsx), CSV, Text (.txt), Images (.jpg, .jpeg, .png, .gif)

When sendChatNotification is true (default), a system message is posted on the case chat
to notify the collection partner that a new file was uploaded.

## Path parameters

- `caseId` string, uuid, required

## Query parameters

- `sendChatNotification` boolean

## Headers

- `Idempotency-Key` string

## Response `200`

File uploaded successfully

## Other responses

- `400` — Validation error
- `404` — Case not found
- `413` — File too large
- `415` — Unsupported file type
- `500` — Internal server error

## Changes

- **2026-09-04** `98a930b13785` — 1 breaking
  - for the `header` request parameter `Idempotency-Key`, the minLength was increased from `0` to `1`

[Change history](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/changes/cases/:caseId/files/post.md)

---

[API](https://skmtc.dev/debitura/apis/debitura-referral-partner-api.md) · [All operations](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/revisions/8186427c1a9b?raw)