Skip to main content

​
Overview

The Update Application endpoint lets you modify an existing application in your Mokaru tracker. Use it to change the status as you progress through your pipeline, adjust priority, add notes, or correct job details. Common use cases:
  • AI agent pipeline management - let an AI agent monitor your email for interview invitations or rejections, then automatically update the corresponding application status. For example, when a recruiter email arrives, the agent can move the application from “applied” to “screening” or “interview_scheduled”.
  • n8n and Make automations - build a workflow that listens for calendar events (interviews) and automatically updates the application status to “interview_scheduled”. After the interview date passes, move it to “interviewed”.
  • Bulk status updates - mark all stale applications as “no_response” after a configurable period by combining the List Applications endpoint with this one.
  • Notes and context tracking - append notes from meetings, phone screens, or research to keep all context in one place.
When you change the status field, a timeline entry is automatically created in the application history. This gives you a complete audit trail of status changes, whether made manually in the app or through the API.
Scope required: tracker:write | Rate limit: 20 requests/min

​
Request

PATCH /v1/tracker/applications/:id

​
Path Parameters

​
id
string
required
The application ID (returned by the Create Application or List Applications endpoint)

​
Body Parameters

All body parameters are optional. Include only the fields you want to update.
​
status
string
Application status. Changing this creates a timeline entry automatically.Options: watchlist, preparing, applied, response, screening, interview_scheduled, interviewed, offer, negotiating, accepted, rejected, withdrawn, no_response
​
priority
number
Priority level (1-5)
​
notes
string
Free-text notes about the application
​
jobTitle
string
Job title (max 200 characters)
​
company
string
Company name (max 200 characters)
​
location
string
Job location (max 200 characters)

​
Example

curl -X PATCH "https://api.mokaru.ai/v1/tracker/applications/clx5678..." \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "interview_scheduled",
    "priority": 5,
    "notes": "Phone screen with hiring manager on March 20"
  }'

​
Response

Returns the full updated application object.
​
id
string
Application ID
​
jobTitle
string
Job title
​
company
string
Company name
​
location
string
Job location
​
jobUrl
string
Link to the job posting
​
status
string
Current status
​
source
string
Where the job was found
​
priority
number
Priority (1-5)
​
notes
string
Application notes
​
salaryMin
number
Minimum salary
​
salaryMax
number
Maximum salary
​
appliedDate
string
ISO 8601 date
​
createdAt
string
ISO 8601 date
​
updatedAt
string
ISO 8601 date
{
  "id": "clx5678...",
  "jobTitle": "Senior Software Engineer",
  "company": "Acme Corp",
  "location": "San Francisco, CA",
  "jobUrl": "https://acme.com/careers/123",
  "status": "interview_scheduled",
  "source": "Other",
  "priority": 5,
  "notes": "Phone screen with hiring manager on March 20",
  "salaryMin": 150000,
  "salaryMax": 200000,
  "appliedDate": "2026-03-15T00:00:00.000Z",
  "createdAt": "2026-03-15T12:00:00.000Z",
  "updatedAt": "2026-03-18T09:30:00.000Z"
}

​
Validation Errors

{
  "error": "Validation failed",
  "details": {
    "status": ["Invalid status value"],
    "priority": ["Must be between 1 and 5"]
  }
}