> ## Documentation Index
> Fetch the complete documentation index at: https://feather.mupeni.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Project

> Creates a new project with three default environments.

Creates a project and automatically seeds three environments: `production`, `staging`, and `development`.

**Project deletion is not available via the API.** Deleting a project cascades to all its environments, flags, flag versions, proposals, and audit log entries — a change that is irreversible. To delete a project, contact support.

## Body

<ParamField body="name" type="string" required>
  Display name for the project.
</ParamField>

<ParamField body="slug" type="string" required>
  URL-safe identifier. Must match `^[a-z0-9-]+$`. Must be unique within the organization.
</ParamField>

## Response

Returns the created project with its seeded `environments` array.

<RequestExample>
  ```bash theme={null}
  curl -X POST https://nest.feather.mupeni.dev/v1/projects \
    -H "Authorization: Bearer <server_key>" \
    -H "Content-Type: application/json" \
    -d '{ "name": "My App", "slug": "my-app" }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "proj_01hx...",
    "orgId": "org_01hx...",
    "name": "My App",
    "slug": "my-app",
    "createdAt": "2024-03-01T12:00:00.000Z",
    "environments": [
      { "id": "env_01hx...", "name": "Production", "slug": "production", "color": "#ef4444", "protected": false },
      { "id": "env_02hx...", "name": "Staging",    "slug": "staging",    "color": "#f59e0b", "protected": false },
      { "id": "env_03hx...", "name": "Development","slug": "development","color": "#22c55e", "protected": false }
    ]
  }
  ```

  ```json 409 theme={null}
  {
    "error": { "code": "CONFLICT", "message": "Slug 'my-app' already exists in this organization." }
  }
  ```
</ResponseExample>