Update an existing Theft Case

put

https://{instance}.my.salesforce.com/services/apexrest/ThinkSDK/thinklp/api/v1/theft-cases

Updates an existing theft case from the supplied body. Returns the { detail, fieldSpecs } envelope. The id query parameter is authoritative. If the body also carries an id, the two values must match, or the API returns 400 BAD_REQUEST.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

string

required

Salesforce Investigation record Id of the case to update

Body Params

The theft case body.

string | null

Salesforce Investigation record Id

investigationType

string | null

Investigation type picklist value (e.g. External Theft, Internal Theft). Immutable after create.

incidentDate

date | null

Date of the incident (YYYY-MM-DD)

incidentTime

string | null

Time of the incident as string (HH:MM)

primaryLocationId

string | null

Salesforce Id of the primary location record

status

string | null

Case status picklist value (Open, Closed, Pending Assignment, Pending Approval)

incidentType

string | null

Incident type picklist value

methodPrimary

string | null

Primary theft method picklist value

methodSecondary

string | null

Secondary theft method picklist value

narrative

string | null

Free-text narrative description of the incident. Required when status is Closed.

initialCaseValue

number | null

Initial estimated value of the case. Immutable after create.

currencyIsoCode

string | null

ISO 4217 currency code that all monetary fields are denominated in (multi-currency orgs)

uuid

string | null

External UUID for cross-system reference. Immutable after create: an update that repoints it at a different value is rejected with 400 IMMUTABLE_FIELD. A value already held by another case is rejected with 409 DUPLICATE_UUID.

investigatorId

string | null

Salesforce User Id of the assigned investigator

promissoryAmount

number | null

Promissory note amount

damages

string | null

Damages picklist value

damageDescription

string | null

Free-text description of damages

actionsTaken

string | null

Actions taken during the incident

preventativeActions

string | null

Preventative actions recommended

policeNotified

string | null

Yes/No picklist indicating if police were notified

policeNotifiedTime

date-time | null

Datetime when police were notified (ISO 8601)

policeArrivalTime

date-time | null

Datetime when police arrived (ISO 8601)

policeDepartment

string | null

Name of the police department

policeOfficerName

string | null

Name of the responding police officer

policeOfficerBadgeNumber

string | null

Badge number of the responding police officer

policeReportNumber

string | null

Police report number

policeDisposition

string | null

Police disposition picklist value

concealmentLocation

string | null

Location where items were concealed

concealmentMethod

string | null

Method used to conceal items

reportDate

date | null

Date the incident was reported

reportTime

string | null

Time the incident was reported (HH:mm:ss)

closedDateTime

date-time | null

Date/time the case was closed (read-only)

involvedPersons

array of objects | null

People associated with this case (suspects, witnesses, employees, law enforcement, and so on). Ordered by Salesforce Id ascending as an insertion-order proxy. Round-trips on GET, PUT, and POST. The insert, update, and delete-orphan cascade applies on PUT.

Body-shape semantics:

An omitted field preserves the existing children (no-op).
An empty array deletes all children.
An explicit null is treated as omitted (no-op).
An unknown id in the payload (a stale client cache) is rejected as BAD_REQUEST.

POST entries must omit id. Concurrency is last-write-wins. PATCH for surgical updates is deferred.

involvedPersons

involvedVehicles

array of objects | null

Vehicles associated with this case.

Body-shape semantics:

An omitted field preserves the existing junctions (no-op).
An empty array deletes all junctions.
An explicit null is treated as omitted (no-op).

The POST-only plate-attach sub-route /theft-cases/{caseId}/involved-vehicles is the path for dedup. The cascade PUT path requires vehicleId on every entry. vehicleId is immutable after create, and a change is rejected with 400 IMMUTABLE_FIELD.

involvedVehicles

caseItems

array of objects | null

Items associated with this case.

Body-shape semantics:

An omitted field preserves the existing junctions (no-op).
An empty array deletes all junctions.
An explicit null is treated as omitted (no-op).

A non-empty array replaces the set. A caseItems entry that carries itemId and no junction id inserts a new link. itemId is immutable after create, and a change is rejected with 400 IMMUTABLE_FIELD. The POST-only SKU-attach sub-route /theft-cases/{caseId}/case-items is the path for dedup.

caseItems

Responses

200OK. The response body is the { detail, fieldSpecs } envelope, reflecting the saved case.

403Field-level security denial. The running user lacks CRUD or FLS on a required field, or a mapping names a field that does not exist. The message names the column. The response body carries no separate field list.

404Resource not found — the supplied id does not resolve to a Theft record type

500Server error, or an org configuration problem. The code field names the reason: RECORD_TYPE_MISSING — the Theft record type is missing on Investigation__c. INTERNAL_SERVER_ERROR — any other unexpected failure.