table.save_view_settings

Save the table layout for a board

Request: PUT/api/v1/boards/{boardId}/table/view-settings
Scope required: boards: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: table_save_view_settings
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Replaces the whole saved layout: which columns are hidden, the order they appear in, their widths and the sort. Send the layout you want to end up with, read from `table.get_view_settings` and amended — this is a PUT, so a field left out is not left alone. A column name the table no longer has is dropped rather than refused, so a layout saved before a column was renamed keeps working. Widths are clamped to what the grid can render.

Parameters

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

Request body

columnOrder: array of string, required
columnWidths: object, required
hiddenFields: array of string, required
sort: object or null, required

Response

columnOrder: array of one of: title, companyName, status, applicationDate, source, workMode, workType, payAmount, payFrequency, salaryRangeMin, salaryRangeMax, city, state, country, companyIndustry, companySize, companyType, companyWebsite, companyLinkedin, applicationLink, description, notes, interviewCount, createdAt, updatedAt, required
columnWidths: object, required
hiddenFields: array of one of: title, companyName, status, applicationDate, source, workMode, workType, payAmount, payFrequency, salaryRangeMin, salaryRangeMax, city, state, country, companyIndustry, companySize, companyType, companyWebsite, companyLinkedin, applicationLink, description, notes, interviewCount, createdAt, updatedAt, required
sort: object or null, required

Examples

Hide the long text columns and sort by application date

Hide the long text columns and sort by application date — request

curl -s -X PUT https://www.jobapplicationtracking.com/api/v1/boards/brd_7/table/view-settings \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "hiddenFields": [
    "notes",
    "description"
  ],
  "columnOrder": [
    "title",
    "companyName",
    "status"
  ],
  "columnWidths": {
    "title": 220
  },
  "sort": {
    "field": "applicationDate",
    "direction": "desc"
  }
}'

Hide the long text columns and sort by application date — response

{
  "hiddenFields": [
    "notes",
    "description"
  ],
  "columnOrder": [
    "title",
    "companyName",
    "status"
  ],
  "columnWidths": {
    "title": 220
  },
  "sort": {
    "field": "applicationDate",
    "direction": "desc"
  }
}