Sign in

v1

latestOpenAPI 3.1.02026-07-24172151607.6 KB
Views

Update View

Rename a view, update the grouping, sorting, filters, columns, and settings of a view.

put/v2/view/{view_id}

Path parameters

view_idstring required
Example:3c

Request body

namestring required
typestring required

Example request

{
  "name": "New 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
  }
}

Response

{"stackTrail":"paths:/v2/view/{view_id}:put:responses:200:content:application/json:schema:properties:view","oasType":"schema","type":"unknown","title":"View"}

Example response

{
  "view": {
    "id": "3c-105",
    "name": "New 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
    }
  }
}