ThinkLP
ThinkLP Case Management API

Persons

Serverhttps://your-org.my.salesforce.com/services/apexrest/ThinkLP

Involved persons (suspects, witnesses, employees) - maps to ThinkLP__Investigation_Contact__c.

Person Types:

  • Suspect - Primary subjects of investigation
  • Witness - Individuals who observed incident
  • Employee - Store staff involved or reporting
  • Victim, Other - Additional role types

List Persons

GET
https://your-org.my.salesforce.com/services/apexrest/ThinkLP
/incidents/{incidentId}/involved-persons

List all persons (suspects, witnesses, employees) for a case.

List Persons › path Parameters

incidentId
​string · pattern: ^[a-zA-Z0-9]{15,18}$ · required

Salesforce case ID (15/18 chars)

List Persons › Headers

API-Version
​string · required

API version

Default: 1.0

List Persons › Responses

List of persons

Person details returned in GET responses
id
​string · readOnly
name
​string · readOnly

Auto-generated name (e.g., IC-110)

incident_id
​string · readOnly · pattern: ^[a-zA-Z0-9]{15,18}$
uuid
​string · uuid · readOnly
first_name
​string · maxLength: 50
last_name
​string · maxLength: 50
middle_name
​string · maxLength: 50
person_type
​string
date_of_birth
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

gender
​string
height
​string
weight
​number
hair_color
​string
eye_color
​string
ethnicity
​string
phone_number
​string
email
​string · email
driver_license_number
​string
employee_id
​string
alias
​string
clothing
​string
identifying_features
​string
apprehension_date_time
​DateTime · date-time

ISO 8601 date-time (RFC3339)

postal_code
​string · maxLength: 10
​AddressNested

Address object returned in GET responses (camelCase keys).

POST/PATCH Input: Use flat snake_case fields (address, address_line_2, city, state, postal_code, country). GET Output: Returns this nested camelCase object. Note that postal_code is also returned as a flat field alongside this object.

Field mappings (POST → GET nested):

  • address → addressLine1
  • address_line_2 → addressLine2
  • postal_code → zipCode
  • city → city (same)
  • state → state (same)
  • country → country (same)

Add Person

POST
https://your-org.my.salesforce.com/services/apexrest/ThinkLP
/incidents/{incidentId}/involved-persons

Add person to case with demographics, contact, and physical details.

Add Person › path Parameters

incidentId
​string · pattern: ^[a-zA-Z0-9]{15,18}$ · required

Salesforce case ID (15/18 chars)

Add Person › Headers

API-Version
​string · required

API version

Default: 1.0

Add Person › Request Body

Person creation payload (POST). Address fields flat (snake_case).
first_name
​string · maxLength: 50
last_name
​string · maxLength: 50
middle_name
​string · maxLength: 50
person_type
​string
date_of_birth
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

gender
​string
height
​string

Height in feet.inches format (e.g., "5.9" for 5'9")

weight
​number · min: 0

Weight in pounds

hair_color
​string
eye_color
​string
ethnicity
​string
phone_number
​string
email
​string · email
driver_license_number
​string
employee_id
​string
alias
​string
clothing
​string
identifying_features
​string
apprehension_date_time
​DateTime · date-time

ISO 8601 date-time (RFC3339)

address
​string · maxLength: 75

Flat address field

address_line_2
​string · maxLength: 75
city
​string · maxLength: 50
state
​string
postal_code
​string · maxLength: 10
country
​string · maxLength: 80

Add Person › Responses

Resource created successfully

success
​boolean
message
​string
id
​string
​object
​object

IDs of nested entities (if created)


Get Person

GET
https://your-org.my.salesforce.com/services/apexrest/ThinkLP
/incidents/{incidentId}/involved-persons/{personId}

Get Person › path Parameters

incidentId
​string · pattern: ^[a-zA-Z0-9]{15,18}$ · required

Salesforce case ID (15/18 chars)

personId
​string · pattern: ^[a-zA-Z0-9]{15,18}$ · required

Salesforce person ID

Get Person › Headers

API-Version
​string · required

API version

Default: 1.0

Get Person › Responses

Person details

Person details returned in GET responses
id
​string · readOnly
name
​string · readOnly

Auto-generated name (e.g., IC-110)

incident_id
​string · readOnly · pattern: ^[a-zA-Z0-9]{15,18}$
uuid
​string · uuid · readOnly
first_name
​string · maxLength: 50
last_name
​string · maxLength: 50
middle_name
​string · maxLength: 50
person_type
​string
date_of_birth
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

gender
​string
height
​string
weight
​number
hair_color
​string
eye_color
​string
ethnicity
​string
phone_number
​string
email
​string · email
driver_license_number
​string
employee_id
​string
alias
​string
clothing
​string
identifying_features
​string
apprehension_date_time
​DateTime · date-time

ISO 8601 date-time (RFC3339)

postal_code
​string · maxLength: 10
​AddressNested

Address object returned in GET responses (camelCase keys).

POST/PATCH Input: Use flat snake_case fields (address, address_line_2, city, state, postal_code, country). GET Output: Returns this nested camelCase object. Note that postal_code is also returned as a flat field alongside this object.

Field mappings (POST → GET nested):

  • address → addressLine1
  • address_line_2 → addressLine2
  • postal_code → zipCode
  • city → city (same)
  • state → state (same)
  • country → country (same)

Update Person

PATCH
https://your-org.my.salesforce.com/services/apexrest/ThinkLP
/incidents/{incidentId}/involved-persons/{personId}

Partial update of person demographics/contact/notes.

Update Person › path Parameters

incidentId
​string · pattern: ^[a-zA-Z0-9]{15,18}$ · required

Salesforce case ID (15/18 chars)

personId
​string · pattern: ^[a-zA-Z0-9]{15,18}$ · required

Salesforce person ID

Update Person › Headers

API-Version
​string · required

API version

Default: 1.0

Update Person › Request Body

Person update payload (PATCH /incidents/{incident_id}/persons/{id}). ## PATCH Semantics - **Omitted fields**: Preserved (not modified) - **Null values**: Clear the field - **Provided values**: Update the field **Response**: Returns full UpdatedResponse with id, attributes, success, message.
first_name
​string · maxLength: 50
last_name
​string · maxLength: 50
middle_name
​string · maxLength: 50
person_type
​string
date_of_birth
​DateOnly · date

Date in YYYY-MM-DD format (RFC3339 full-date)

gender
​string
height
​string
weight
​number
hair_color
​string
eye_color
​string
ethnicity
​string
phone_number
​string
email
​string · email
driver_license_number
​string
employee_id
​string
alias
​string
clothing
​string
identifying_features
​string
apprehension_date_time
​DateTime · date-time

ISO 8601 date-time (RFC3339)

address
​string · maxLength: 75
address_line_2
​string · maxLength: 75
city
​string · maxLength: 50
state
​string
postal_code
​string · maxLength: 10
country
​string · maxLength: 80

Update Person › Responses

Resource updated successfully

Response for successful PATCH operations. Returns the updated resource ID and attributes.
success
​boolean
message
​string
id
​string

ID of the updated resource

​object

Resource metadata