Create Project

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

{
  "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 }
  ]
}

{
  "error": { "code": "CONFLICT", "message": "Slug 'my-app' already exists in this organization." }
}

POST

projects

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

{
  "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 }
  ]
}

{
  "error": { "code": "CONFLICT", "message": "Slug 'my-app' already exists in this organization." }
}

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

string

required

Display name for the project.

string

required

URL-safe identifier. Must match ^[a-z0-9-]+$. Must be unique within the organization.

Response

Returns the created project with its seeded environments array.

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

{
  "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 }
  ]
}

{
  "error": { "code": "CONFLICT", "message": "Slug 'my-app' already exists in this organization." }
}

List Projects Get Project

Getting Started

Concepts

Management API

Delivery API

Body

Response

​Body

​Response

Body

Response