profile.update

Change the personal details used to fill in application forms

Request: PATCH/api/v1/profile
Scope required: profile:write
Effect: Changes data. Send an Idempotency-Key if you might retry it.
Acts on: Acts on the account’s own job search.
MCP tool: profile_update
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Changes the fields you name and leaves the rest alone. Send an empty string to clear a field. Everything sensitive is re-encrypted at rest, and the response is the whole profile as it now stands. Send the `ETag` from `profile.get` as `If-Match` to be refused with 412 if the profile changed in between.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
If-Match	header	Optional	string — The ETag of the version you read. The write is refused with 412 if the resource has changed since.

Request body

authorizedForWorkInUnitedStates: one of: yes, no, optional
city: string, optional
country: string, optional
county: string, optional
currentCompany: string, optional
currentTitle: string, optional
email: string, optional
firstName: string, optional
hasBachelorDegree: one of: yes, no, optional
lastName: string, optional
linkedIn: string, optional
middleName: string, optional
phone: string, optional
phoneCountryCode: string, optional
postalCode: string, optional
requiresVisaSponsorship: one of: yes, no, optional
state: string, optional
streetAddress1: string, optional
streetAddress2: string, optional
streetAddress3: string, optional
title: string, optional

Response

authorizedForWorkInUnitedStates: one of: yes, no, required
city: string, required
country: string, required
county: string, required
currentCompany: string, required
currentTitle: string, required
email: string, required
firstName: string, required
hasBachelorDegree: one of: yes, no, required
lastName: string, required
linkedIn: string, required
middleName: string, required
phone: string, required
phoneCountryCode: string, required
postalCode: string, required
requiresVisaSponsorship: one of: yes, no, required
state: string, required
streetAddress1: string, required
streetAddress2: string, required
streetAddress3: string, required
title: string, required

Examples

Record a new phone number

Record a new phone number — request

curl -s -X PATCH https://www.jobapplicationtracking.com/api/v1/profile \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "phone": "5551234567"
}'

Record a new phone number — response

{
  "firstName": "Riley",
  "middleName": "",
  "lastName": "Bennett",
  "title": "",
  "email": "riley@example.com",
  "phone": "5551234567",
  "phoneCountryCode": "1",
  "streetAddress1": "18 Prairie Street",
  "streetAddress2": "",
  "streetAddress3": "",
  "city": "Chicago",
  "county": "Cook",
  "state": "Illinois",
  "country": "United States",
  "postalCode": "60601",
  "authorizedForWorkInUnitedStates": "yes",
  "requiresVisaSponsorship": "no",
  "hasBachelorDegree": "yes",
  "currentTitle": "Senior Engineer",
  "currentCompany": "Northwind",
  "linkedIn": "https://www.linkedin.com/in/riley-bennett"
}