Create a new Theft Case

post

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

Creates a theft case from the supplied body. This endpoint only creates, so do not include an id field. A body that carries one returns 400 BAD_REQUEST.

Supply investigationType. Any other field you leave null takes a default, so status becomes Open and incidentDate becomes today.

A retry is not safe here. Sending a uuid that an existing case already holds returns 409 DUPLICATE_UUID.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

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. detail carries the saved case, with its platform-assigned id populated.

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.

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.