Update Application

Update a tracked application in your pipeline

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"]
  }
}