monday.com board views allows you to visualize your board data differently through colors, shapes, and graphs.

Queries

You can retrieve monday.com board view data via the API through the views query.

• Returns an array containing metadata about a collection of board views
• Can only be nested inside a boards query

query {
  boards (ids: 1234567890) {
    views {
      type
      settings_str
      view_specific_data_str
      name
      id
    }
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($board: [ID!]) { boards (ids: $board) { views { id name type } } }`
const variables = {
  board: 1234567
}
const response = await mondayApiClient.request(query, variables);

Arguments

You can use the following argument(s) to reduce the number of results returned in your views query.

Fields

You can use the following field(s) to specify what information your views query will return.

Mutations

The API allows you to create, update, and delete board views using the following mutations. These operations let you programmatically control a view's full lifecycle.

Create view

Required scope: boards:write

The create_view mutation creates a new board view via the platform API. You can also specify what fields to query back from the tag when you run the mutation.

mutation {
  create_view (
    board_id: 1234567890
    type: APP
    name: "My app view"
    settings: {
      app_feature_id: 54321
    }
  ) {
    id
    name
  }
}

{
  "data": {
    "create_view": {
      "id": "9876543210",
      "name": "My app view"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Arguments

You can use the following arguments to define the new board view's characteristics.

Create view table

Required scope: boards:write

The create_view_table mutation creates a new table board view via the platform API. You can also specify what fields to query back from the tag when you run the mutation.

mutation {
  create_view_table (
    board_id: 1234567890
    name: "My new table view"
  ) {
    id
    name
  }
} 

{
  "data": {
    "create_view_table": {
      "id": "9876543210",
      "name": "My new table view"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Arguments

You can use the following arguments to define the new table board view's characteristics.

Update view

Required scope: boards:write

The update_view mutation updates a board view via the platform API. You can also specify what fields to query back from the tag when you run the mutation.

mutation {
  update_view (
    board_id: 1234567890
    view_id: 54321
    sort: {
      column_id: "name"
      direction: asc
    }
    type:TABLE
  ) {
    id
    sort
  }
}

{
  "data": {
    "update_view": {
      "id": "54321",
      "sort": [
        {
          "column_id": "name",
          "direction": "ASC"
        }
      ]
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Arguments

You can use the following arguments to define the update board view's characteristics.

Update view table

Required scope: boards:write

The update_view_table mutation updates a table board view via the platform API. You can also specify what fields to query back from the tag when you run the mutation.

mutation {
  update_view_table(
    board_id: 1234567890
    view_id: 54321
    settings: {
      columns:{
        column_properties:{
          column_id:"date",
          visible: false
        }
      }
    }
  ) {
    id
    sort
  }
}

Arguments

You can use the following argument(s) to define the updated table board view's characteristics.

Delete view

Required scope: boards:write

The delete_view mutation deletes a board view via the platform API. You can also specify what fields to query back from the tag when you run the mutation.

mutation {
  delete_view (
    board_id: 1234567890
    view_id: 54321
	) {
    name
  }
}

{
  "data": {
    "delete_view": {
      "name": "Deleted Form"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Arguments

You can use the following arguments to specify which board view to delete.