project

Create a new bucket

Changed on Jul 18, 2026

Creates a new kanban bucket on a project.

put/projects/{id}/views/{view}/buckets

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/{id}/views/{view}/buckets
Auth
API key in header Authorization

Path parameters

idinteger required

Project Id

viewinteger required

Project view ID

Request body

countinteger

The number of tasks currently in this bucket

createdstring

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

idinteger

The unique, numeric id of this bucket.

limitinteger

How many tasks can be at the same time on this board max

positionnumber

The position this bucket has when querying all buckets. See the tasks.position property on how to use this.

project_view_idinteger

The project view this bucket belongs to.

titlestring

The title of this bucket.

updatedstring

A timestamp when this bucket was last updated. You cannot change this value.

Response

The created bucket object.