---
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'

## Request body

- object
  - `name` string, required — Project name. Supports letters, numbers, spaces, dashes, underscores, apostrophes, parentheses, and periods.
  - `defaultLocale` string, required — Source locale for the project.
  - `cdnEnabled` boolean — Enable CDN delivery for the new project.

## Response `201`

Project created.

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

## Other responses

- `400` — The request was invalid.
- `401` — Missing, invalid, or non-organization API key.
- `403` — The API key lacks `org:projects:create` or is blocked by an access policy, or `cdnEnabled` is true and the key lacks `project:write`.
- `409` — The organization has reached its project limit.
- `429` — Rate limit or quota exceeded.
- `500` — The project could not be created.

---

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