project

Create a project view

Changed on Jul 18, 2026

Create a project view in a specific project.

put/projects/{project}/views

Request

Base URL
/api/v1 (relative, and the document was published on a file host, not at the API’s origin)
URL
/api/v1/projects/{project}/views
Auth
API key in header Authorization

Path parameters

projectinteger required

Project ID

Request body

bucket_configuration_mode'none' | 'manual' | 'filter'

The bucket configuration mode. Can be none, manual or filter. manual allows to move tasks between buckets as you normally would. filter creates buckets based on a filter for each bucket.

createdstring

A timestamp when this reaction was created. You cannot change this value.

default_bucket_idinteger

The ID of the bucket where new tasks without a bucket are added to. By default, this is the leftmost bucket in a view.

done_bucket_idinteger

If tasks are moved to the done bucket, they are marked as done. If they are marked as done individually, they are moved into the done bucket.

idinteger

The unique numeric id of this view

positionnumber

The position of this view in the list. The list of all views will be sorted by this parameter.

project_idinteger

The project this view belongs to

titlestring

The title of this view

updatedstring

A timestamp when this view was updated. You cannot change this value.

view_kind'list' | 'gantt' | 'table' | 'kanban'

The kind of this view. Can be list, gantt, table or kanban.

Response

The created project view