DEdebitura
ManagedCases

Upload a file to a managed case

Changed on

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: Description is limited to 500 characters.

DocumentType is case-insensitive. Omit it when the type is unknown; the file is stored as not specified and returned as null. Valid values: OriginalInvoice, AccountStatement, Contract, TermsAndConditions, ProofOfDelivery, DemandLetter, Correspondence, PaymentProof, CourtDocument, IdentityDocument, Miscellaneous. Legacy names remain accepted for existing integrations: DebtorDocuments, CreditorDocuments, PartnerDocuments. Unknown names, numeric values, and AutoGeneratedSummary are rejected with 400 and error InvalidDocumentType.

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.

post/managed-cases/{id}/files

Request

  • Base URL
    https://collectionpartner-api.debitura.com
  • URL
    https://collectionpartner-api.debitura.com/managed-cases/{id}/files
  • Auth
    API key in header XApiKey

Path parameters

idstring uuid required

Headers

Idempotency-Keystring

Optional non-empty, non-whitespace idempotency key (max 255 characters) for safely retrying this request. If a previous request used the same key with an identical body, the original terminal response is replayed verbatim. Reusing the key with a different body returns 422 with businessErrors[0].type: "IdempotencyConflict". Field-level 400 validation errors are not stored, so you may fix the request and retry with the same key.

Request body multipart/form-data

Filestring binary

The file to upload. Required. Allowed extensions: .pdf .doc .docx .xls .xlsx .jpg .jpeg .png .txt .zip .csv .eml Maximum size: 25 MB.

DocumentTypestring

Optional document type, case-insensitive. Omit (or pass null) when you do not know it; the file is then stored as not specified. Valid values: OriginalInvoice, AccountStatement, Contract, TermsAndConditions, ProofOfDelivery, DemandLetter, Correspondence, PaymentProof, CourtDocument, IdentityDocument, Miscellaneous. Still accepted for existing integrations: DebtorDocuments, CreditorDocuments, PartnerDocuments. Any other value is rejected with 400 and error "InvalidDocumentType".

Descriptionstring

Optional free-text description / label for the file (max 500 characters).

Response

File uploaded successfully

idstring uuid
dateCreatedstring date-time
dateUpdatedstring date-time
caseIdstring uuid
entityTypestring nullable
entityIdstring uuid
fileNamestring nullable
urlstring nullable
descriptionstring nullable
documentTypestring nullable

Changes