Create and attach a document to a checklist item

POST

/handover/cases/{caseId}/checklist/{itemId}/documents

Maintainer:Not configured

Creates a new document record (with S3 file reference) and immediately attaches it to the given checklist item. This is the single-call backend for the UI '+ Add Document' button on an expanded checklist item row.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

API Key

Add parameter in header

x-tenant-id

Example:

x-tenant-id: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Document created and attached successfully

Body

🟠400

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/handover/cases//checklist//documents' \
--header 'Authorization: Bearer <token>' \
--header 'x-tenant-id: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "s3Key": "string",
    "fileName": "string",
    "fileSize": 0,
    "notes": "string",
    "issuedBy": "string"
}'

Response Example

200 - Success

{
    "id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
    "handoverCase": "11111111-1111-1111-1111-111111111111",
    "checklistItemId": "33333333-3333-3333-3333-333333333333",
    "status": "UPLOADED",
    "fileS3Key": "handover/cases/111/possession-receipt.pdf",
    "fileName": "possession-receipt.pdf",
    "fileSize": 2150400,
    "issuedBy": "Ravi Kumar",
    "notes": "Signed copy from buyer"
}

Modified at 2026-04-16 18:43:47

Get documents attached to a checklist item

Sign possession receipt