table.get_view_settings

Read the saved table layout for a board

Request: GET/api/v1/boards/{boardId}/table/view-settings
Scope required: boards:read
Effect: Reads only. Safe to retry and safe for an agent to call unprompted.
Acts on: Acts on the account’s own job search.
MCP tool: table_get_view_settings
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Answers which columns are hidden, the order they appear in, how wide they are, and the column the table is sorted by. The layout belongs to the credential's own account rather than to the board, so a board that has never been laid out answers with the defaults instead of 404. This is presentation only — it changes nothing about which applications `table.list_rows` returns. Save a layout with `table.save_view_settings`.

Parameters

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

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

A board laid out with the notes column hidden

A board laid out with the notes column hidden — request

curl -s https://www.jobapplicationtracking.com/api/v1/boards/brd_7/table/view-settings \
  -H "Authorization: Bearer $JAT_KEY"

A board laid out with the notes column hidden — response

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