Skip to main content

applications.bulk_move

Move many applications into one column at once

Request
POST/api/v1/boards/{boardId}/applications/bulk-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_bulk_move
Environment
Live and sandbox alike.
Request body
JSON.

What it does

Moves up to 200 cards on one board into the same status in a single transaction: either every card moves or none does, so a batch that names a card on another board or another account is refused with 422 and changes nothing. This is the operation for "archive everything I was rejected from before June" — find the ids with `applications.list` and send them here rather than calling `applications.move` in a loop, which would leave the board half-changed if one call failed. Each card that actually changes column closes its open status-history row and opens a new one; a card already in that column is left untouched and is not counted in `movedCount`. Returns the board’s updated columns.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
NameSent inRequirementAccepts
boardIdpathRequiredstring

Request body

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

Response

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
id
string, required
movedCount
integer, required

Examples

Archive two rejections

Archive two rejections — request
curl -s -X POST https://www.jobapplicationtracking.com/api/v1/boards/brd_7/applications/bulk-move \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "applicationIds": [
    "app_123",
    "app_124"
  ],
  "status": "archived"
}'
Archive two rejections — response
{
  "board": {
    "id": "brd_7",
    "columns": {
      "saved": [],
      "applied": [],
      "interviewing": [],
      "offer": [],
      "rejected": [],
      "accepted": [],
      "archived": [
        "app_124",
        "app_123"
      ]
    }
  },
  "movedCount": 2
}

Related operations