applications.update

Edit the details of one application

Request

PATCH/api/v1/applications/{applicationId}

Scope required

applications: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

applications_update

Environment

Live and sandbox alike.

Request body

JSON.

What it does

Changes any of a card’s own fields — its notes, source, link, dates, résumé, and the nested `job` and `company` objects. A field you leave out keeps its current value, and a nested object you send is merged field by field rather than replacing the whole thing. It refuses a `status` with 422: moving a card between columns opens a new status-history row, which is `applications.move`’s job. Naming a `company.id` that differs from the current one moves the card to that company; naming only company fields edits the company it already has, for every card filed against it. A `company.id` that does not belong to this account is refused with 422. Send the `ETag` from `applications.get` as `If-Match` to be refused with 412 if the card changed in between.

Parameters

Request body

applicationDate

string or null, optional

applicationLink

string or null, optional

company

object, optional

id

any, optional

industry

one of: agriculture, arts, automotive, banking, biotechnology, chemical, communications, construction, consulting, education, electronics, energy, engineering, entertainment, environmental, finance, food, government, healthcare, hospitality, insurance, legal, manufacturing, media, non_profit, pharmaceutical, real_estate, retail, software, sports, technology, telecommunications, transportation, travel, other, unknown, optional

linkedin

string or null, optional

name

string, optional

size

one of: tiny, small, medium, large, massive or null, optional

type

one of: government_agency, non_profit, private, public or null, optional

website

string or null, optional

job

object, optional

compensation

object, optional

currency

string, optional

payAmount

number or null, optional

payFrequency

one of: hourly, weekly, biweekly, monthly, annually, other, optional

salaryRangeMax

number or null, optional

salaryRangeMin

number or null, optional

description

string or null, optional

location

object, optional

city

string or null, optional

country

string or null, optional

postalCode

string or null, optional

state

string or null, optional

street

string or null, optional

street2

string or null, optional

title

string, optional

workMode

one of: remote, hybrid, onsite, optional

workType

one of: full_time, part_time, contract, temporary, internship, optional

notes

string or null, optional

resumeId

string or null, optional

source

string or null, optional

status

one of: saved, applied, interviewing, offer, rejected, accepted, archived, optional

Response

applicationDate

string or null, required

applicationLink

string or null, required

boardId

string, required

company

object, required

id

string, required

industry

one of: agriculture, arts, automotive, banking, biotechnology, chemical, communications, construction, consulting, education, electronics, energy, engineering, entertainment, environmental, finance, food, government, healthcare, hospitality, insurance, legal, manufacturing, media, non_profit, pharmaceutical, real_estate, retail, software, sports, technology, telecommunications, transportation, travel, other, unknown, required

linkedin

string or null, required

name

string, required

size

one of: tiny, small, medium, large, massive or null, required

type

one of: government_agency, non_profit, private, public or null, required

website

string or null, required

counts

object, required

coachNotes

integer, required

interviews

integer, required

createdAt

string, required

creationMethod

one of: form, csv_import, plugin, api, required

id

string, required

isAutoRetired

boolean, required

job

object, required

compensation

object or null, required

description

string or null, required

location

object or null, required

title

string, required

workMode

one of: remote, hybrid, onsite, required

workType

one of: full_time, part_time, contract, temporary, internship, required

notes

string or null, required

resume

object or null, required

source

string or null, required

status

one of: saved, applied, interviewing, offer, rejected, accepted, archived, required

statusChangedAt

string or null, required

updatedAt

string, required

Examples

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

{
  "id": "app_123",
  "boardId": "brd_7",
  "status": "applied",
  "statusChangedAt": "2026-02-11T17:05:00.000Z",
  "applicationDate": "2026-02-11T00:00:00.000Z",
  "applicationLink": "https://example.com/jobs/staff-engineer",
  "source": "LinkedIn",
  "notes": "Referred by a former colleague.",
  "isAutoRetired": false,
  "creationMethod": "form",
  "job": {
    "title": "Staff Engineer",
    "description": "Own the billing platform.",
    "workMode": "remote",
    "workType": "full_time",
    "location": {
      "street": null,
      "street2": null,
      "city": "Austin",
      "state": "Texas",
      "country": "United States",
      "postalCode": null
    },
    "compensation": {
      "payAmount": 195000,
      "payFrequency": "annually",
      "currency": "USD",
      "salaryRangeMin": null,
      "salaryRangeMax": null
    }
  },
  "company": {
    "id": "co_42",
    "name": "Northwind",
    "industry": "software",
    "size": "medium",
    "type": "private",
    "website": "https://northwind.example",
    "linkedin": null
  },
  "resume": null,
  "counts": {
    "interviews": 1,
    "coachNotes": 0
  },
  "createdAt": "2026-02-11T17:05:00.000Z",
  "updatedAt": "2026-02-11T17:05:00.000Z"
}

Related operations