Sign in
Views

Create Workspace (Everything level) View

Add a List, Board, Calendar, Table, Timeline, Workload, Activity, Map, Chat, or Gantt view at the Everything Level of a Workspace.

post/v2/team/{team_id}/view

Path parameters

team_idnumber required
Example:123

Workspace ID

Request body

namestring required
typestring required

The type of view to create. Options include: list, board, calendar, table, timeline, workload, activity, map, conversation, or gantt.

groupingGrouping required— unresolved $ref
divideDivide required— unresolved $ref
sortingSorting required— unresolved $ref
filtersFilters required— unresolved $ref
columnsColumns required— unresolved $ref
team_sidebarTeamSidebar required— unresolved $ref
settingsSettings required— unresolved $ref

Example request

{
  "name": "New Team View Name",
  "type": "list",
  "grouping": {
    "field": "status",
    "dir": 1,
    "collapsed": [],
    "ignore": false
  },
  "divide": {
    "field": null,
    "dir": null,
    "collapsed": []
  },
  "sorting": {
    "fields": []
  },
  "filters": {
    "op": "AND",
    "fields": [],
    "search": "",
    "show_closed": false
  },
  "columns": {
    "fields": []
  },
  "team_sidebar": {
    "assignees": [],
    "assigned_comments": false,
    "unassigned_tasks": false
  },
  "settings": {
    "show_task_locations": false,
    "show_subtasks": 3,
    "show_subtask_parent_names": false,
    "show_closed_subtasks": false,
    "show_assignees": true,
    "show_images": true,
    "collapse_empty_columns": null,
    "me_comments": true,
    "me_subtasks": true,
    "me_checklists": true
  }
}

Response

viewView required— unresolved $ref

Example response

{
  "view": {
    "id": "3c-105",
    "name": "New Team View Name",
    "type": "list",
    "parent": {
      "id": "512",
      "type": 7
    },
    "grouping": {
      "field": "status",
      "dir": 1,
      "collapsed": [],
      "ignore": false
    },
    "divide": {
      "field": null,
      "dir": null,
      "collapsed": []
    },
    "sorting": {
      "fields": []
    },
    "filters": {
      "op": "AND",
      "fields": [],
      "search": "",
      "show_closed": false
    },
    "columns": {
      "fields": []
    },
    "team_sidebar": {
      "assignees": [],
      "assigned_comments": false,
      "unassigned_tasks": false
    },
    "settings": {
      "show_task_locations": false,
      "show_subtasks": 3,
      "show_subtask_parent_names": false,
      "show_closed_subtasks": false,
      "show_assignees": true,
      "show_images": true,
      "collapse_empty_columns": null,
      "me_comments": true,
      "me_subtasks": true,
      "me_checklists": true
    }
  }
}

Changes