---
title: "Create a Project"
method: POST
path: "/v2/projects"
tags: ["Project"]
---

# Create a Project

`POST /v2/projects`

Create a Project in the Organization associated with an Organization API key. The key must have the `org:projects:create` permission. Project keys cannot use this endpoint. Enabling CDN delivery also requires `project:write`.

## Headers

- `gt-api-version` '2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1' — API contract version. Defaults to the oldest supported version.

## Request body

- object
  - `name` string, required
  - `defaultLocale` string, required
  - `cdnEnabled` boolean

## Response `201`

Project created

- object
  - `project` object, required
    - `id` string, required
    - `name` string, required
    - `orgId` string, required
    - `defaultLocale` string, required

## Other responses

- `400` — Request error
- `401` — Request error
- `403` — Request error
- `409` — Request error
- `413` — Request error
- `429` — Request error
- `500` — Request error

## Changes

- **2026-08-27** `367cd605d090` — 16 info
  - the endpoint scheme security `BearerAuth` was added to the API
  - the `cdnEnabled` request property default value `false` was removed
  - the `name` request property's minLength was decreased from `1` to `0`
  - added the media type `text/html` for the response with the status `400`
  - …12 more

[Change history](https://skmtc.dev/generaltranslation/apis/general-translation-api/changes/v2/projects/post.md)

---

[API](https://skmtc.dev/generaltranslation/apis/general-translation-api.md) · [All operations](https://skmtc.dev/generaltranslation/apis/general-translation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/generaltranslation/general-translation-api/revisions/5f954204ea21/schema)