applications.move

Move an application to another column, or reorder it within one

Request: POST/api/v1/applications/{applicationId}/move
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_move
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Changes an application's status — its column on the board — and optionally where it sits in that column. Use this instead of `applications.update` for any status change; `applications.update` rejects one. Moving to `rejected` or `archived` closes the current status-history row and opens a new one, which is what the time-in-status figures read, so do not move a card through intermediate columns to "catch up" — the history will say it happened today. To reorder inside the column a card already sits in, pass its current status together with a `position`. Returns the card, the board’s updated column ordering, and the status it came from.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
applicationId	path	Required	string

Request body

position: object or object or object, optional
status: one of: saved, applied, interviewing, offer, rejected, accepted, archived, required

Response

application

object, required

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

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

board

object, required

columns

object, required

accepted: array of string, required
applied: array of string, required
archived: array of string, required
interviewing: array of string, required
offer: array of string, required
rejected: array of string, required
saved: array of string, required

string, required

previousStatus

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

Examples

Move a card to the top of Interviewing

Move a card to the top of Interviewing — request

curl -s -X POST https://www.jobapplicationtracking.com/api/v1/applications/app_123/move \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "interviewing",
  "position": {
    "first": true
  }
}'

Move a card to the top of Interviewing — response

{
  "application": {
    "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"
  },
  "board": {
    "id": "brd_7",
    "columns": {
      "saved": [],
      "applied": [],
      "interviewing": [
        "app_123"
      ],
      "offer": [],
      "rejected": [],
      "accepted": [],
      "archived": []
    }
  },
  "previousStatus": "applied"
}

applications.move

What it does

Parameters

Request body

Response

Examples

Move a card to the top of Interviewing

Related operations