---
title: "Create project"
method: POST
path: "/v1/projects"
tags: ["Projects"]
---

# Create project

`POST /v1/projects`

Create a new project in your Dovetail workspace. Projects are the primary container for organizing research — they hold data, docs, highlights, tags, and insights.

Optionally provide a `template_id` to create the project from an existing workspace template. The new project will inherit the template's fields, views, tags, and other structural elements. Retrieve available templates using the **List project templates** (`GET /v1/projects/templates`) endpoint.

Optionally provide a `folder_id` to create the project inside an existing folder. If omitted, the project is created at the workspace root level.

Returns the newly created project object.

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

## Request body

- object
  - `title` string — The project's title.
  - `template_id` string — The ID of a workspace template to use when creating the project. The new project will be pre-populated with the template's fields, views, and structure.
  - `folder_id` string — The ID of a folder to create the project inside. If omitted, the project is created at the workspace root level.

## Response `201`

201

- object
  - `data` object, required
    - `id` string, required
    - `url` string — The URL of this resource in the Dovetail web app. This field is experimental and may change without notice.
    - `author` object, nullable, required
      - `id` string, required
      - `name` string, nullable, required
    - `title` string, required
    - `type` 'project', required
    - `created_at` string, required
    - `deleted` boolean, required
    - `folder` object, nullable, required
      - `id` string, required

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/dovetail/apis/dovetail-public-api.md) · [All operations](https://skmtc.net/dovetail/apis/dovetail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dovetail/dovetail-public-api/versions/4107f5fdf8b2/schema)