---
title: "Create a project (its own API keys and documents)"
method: POST
path: "/projects"
tags: ["Dashboard"]
---

# Create a project (its own API keys and documents)

`POST /projects`

## Request

- Base URL: `https://api.eu.doconda.com/v1`
- URL: `https://api.eu.doconda.com/v1/projects`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required

## Response `201`

Created.

- object
  - `id` string, required
  - `name` string, required
  - `retention` 'none' | '1d' | '7d' | '30d' | '90d', required: Default retention of the project's documents and of the files uploaded to it (ADR-0036).
  - `created_at` string, date-time, required

## Other responses

- `401`: unauthorized (missing, unknown or revoked key; expired session).
- `403`: session_required: dashboard only.

---

[API](https://skmtc.dev/doconda/apis/doconda-api.md) · [All operations](https://skmtc.dev/doconda/apis/doconda-api/llms.txt) · [OpenAPI document](https://skmtc.dev/doconda/apis/doconda-api/revisions/27d29a7e8902?raw)
