Update a claim

curl --request PATCH \
  --url http://localhost:3000/api/claims/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "material": "<string>",
  "pane": "<string>",
  "description": "<string>",
  "defectStation": "<string>",
  "reportedBy": "<string>",
  "approvedBy": "<string>",
  "remadePane": "<string>",
  "remakeStation": "<string>",
  "photos": [
    "<string>"
  ],
  "claimDate": "2023-11-07T05:31:56Z"
}
'

{
  "success": true,
  "message": "<string>",
  "data": {
    "_id": "<string>",
    "claimNumber": "CLM-0001",
    "order": "<string>",
    "pane": "<string>",
    "material": "<string>",
    "description": "<string>",
    "defectStation": "<string>",
    "reportedBy": "<string>",
    "status": "pending",
    "approvedBy": "<string>",
    "remadePane": "<string>",
    "photos": [],
    "claimDate": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}

Claims

Update a claim

Requires claims:view permission. Users without claims:manage permission can only update their own claims.

Approval orchestration: When status is changed to approved (from any other status) and no remadePane exists yet, the system automatically:

Creates a new remake pane with the same specs as the original (dimensions, rawGlass, jobType, glassType, processes, edgeTasks, routing) cloned from the original pane.
If remakeStation (Station ObjectId) is provided, the remake pane is placed at that station (currentStation: <remakeStation>, currentStatus: pending). If omitted, currentStation is null (queued). The pane is created with order: null.
The remake pane belongs to the same request as the original order (request is copied).
The remake pane’s remakeOf field points to the original defective pane.
The claim’s remadePane field is set to the new pane’s ID.
A MaterialLog entry with actionType: remake is created.
Real-time events are emitted: pane:updated, station:pane_arrived (to the target station room if remakeStation was provided), and a notification to the original order’s assignedTo worker.

The frontend should send remakeStation with the ObjectId of the order release station (identified by its OrderReleasePanel UI block).

This fires regardless of the decision field (both keep and destroy). Setting status to rejected does not create a remake pane. Re-approving an already-approved claim (or one that already has a remadePane) does not create a duplicate.

PATCH

api

claims

{id}

Update a claim

curl --request PATCH \
  --url http://localhost:3000/api/claims/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "material": "<string>",
  "pane": "<string>",
  "description": "<string>",
  "defectStation": "<string>",
  "reportedBy": "<string>",
  "approvedBy": "<string>",
  "remadePane": "<string>",
  "remakeStation": "<string>",
  "photos": [
    "<string>"
  ],
  "claimDate": "2023-11-07T05:31:56Z"
}
'

{
  "success": true,
  "message": "<string>",
  "data": {
    "_id": "<string>",
    "claimNumber": "CLM-0001",
    "order": "<string>",
    "pane": "<string>",
    "material": "<string>",
    "description": "<string>",
    "defectStation": "<string>",
    "reportedBy": "<string>",
    "status": "pending",
    "approvedBy": "<string>",
    "remadePane": "<string>",
    "photos": [],
    "claimDate": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Resource ID

Body

application/json

source

enum<string>

Available options:

customer,

worker

material

string

Minimum string length: 1

pane

string

Minimum string length: 1

description

string

Minimum string length: 1

defectCode

enum<string>

Available options:

broken,

chipped,

dimension_wrong,

scratch,

stain,

other

defectStation

string

Station ObjectId where defect was found

status

enum<string>

Available options:

pending,

approved,

rejected

decision

enum<string>

Available options:

destroy,

keep

reportedBy

string

Minimum string length: 1

approvedBy

string

Minimum string length: 1

remadePane

string

Minimum string length: 1

remakeStation

string

Station ObjectId where the remake pane should land (e.g. order release station). Frontend sends this when approving a claim.

Minimum string length: 1

photos

string<uri>[]

claimDate

string<date-time>

Response

Claim updated

success

boolean

Example:

true

message

string

data

object

Show child attributes

Get claim by ID Delete a claim