Sign in
Views

Create Space View

Add a List, Board, Calendar, Table, Timeline, Workload, Activity, Map, Chat, or Gantt view to a Space.

post/v2/space/{space_id}/view

Path parameters

space_idnumber required
Example:790

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 Space 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-106",
    "name": "New Space View Name",
    "type": "list",
    "parent": {
      "id": "790",
      "type": 4
    },
    "grouping": {
      "field": "status",
      "dir": 1,
      "collapsed": [],
      "ignore": false
    },
    "divide": {
      "field": null,
      "dir": null,
      "collapsed": []
    },
    "sorting": {
      "fields": {
        "field": "cf_624a423a-c1d1-4467-99e2-63e225658cb2",
        "dir": -1,
        "idx": 0
      }
    },
    "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