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

# Create a project

`POST /api/v1/projects`

## Request

- Base URL: `https://sprintflint.com`
- URL: `https://sprintflint.com/api/v1/projects`
- Auth: API key in header `X-API-Token`

Creates a new project in the organisation

## Request body

- object
  - `project` object
    - `name` string, required: Project name
    - `prefix` string, required: Issue prefix (2-4 uppercase alphanumeric characters)
    - `description` string: Project description
    - `documentation_url` string: Documentation URL
    - `production_url` string: Production URL

## Response `201`

project created

- Project
  - `id` integer, required
  - `name` string, required
  - `prefix` string, required
  - `description` string, nullable
  - `documentation_url` string, nullable
  - `production_url` string, nullable
  - `github_repo_owner` string, nullable
  - `github_repo_name` string, nullable
  - `sprints_count` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: validation errors

---

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