Spaces and projects

Spaces group related projects, such as a client or a department. Projects hold the tasks. Create and read both through the API.

List your spaces

Get all spaces returns the spaces you have joined. Deleted and archived spaces are left out.

Create a space

Create a new space needs spaceName and spaceType. The type is Public_To_All, Public_To_Request or Private. You become the space's admin.

List projects in a space

Get all projects in a space returns one page at a time. When hasMore is true, ask for the next page. Filter by status, priority, health, members, tags, dates and more. See Pagination and filtering.

Create a project

Create a new project needs only name. The other fields are optional:

Field	What to send
`status`, `priority`, `health`	The name of a value that exists in your workspace
`projectTags`	Names of existing tags
`isPublic`	`true` to show the project to everyone in the space
`startDate`, `dueDate`	Date-time in ISO 8601
`projectType`	`FIXED_FEE`, `TIME_AND_MATERIAL` or `RETAINER`

Update a project

Update a project changes only the fields you send. The rest keep their values.

WARNING

A project's projectType can be changed once. After that, requests that change it again are refused.

Delete spaces and projects

Delete a project also deletes all of its tasks. Delete a space deletes its projects and their tasks.

Find people to assign

Get project details by ID lists the project's members in projectMembers. Use their user.userId as task owners.

API reference

Action	Endpoint
List spaces	Get all spaces
Get a space	Get space by ID
Create, update, delete a space	Create, Update, Delete
List projects	Get all projects in a space
Get a project	Get project details by ID
Create, update, delete a project	Create, Update, Delete
Export all projects	Bulk list projects

List your spaces#

Create a space#

List projects in a space#

Create a project#

Update a project#

Delete spaces and projects#

Find people to assign#

API reference#

List your spaces

Create a space

List projects in a space

Create a project

Update a project

Delete spaces and projects

Find people to assign

API reference