Projects
Projects
Create, list, retrieve, and delete FlagForge projects
Overview
Projects are top-level containers in the FlagForge control plane. A project owns its environments, flags, segments, API keys, webhooks, and audit logs. Use this resource to create a project, list projects visible to the authenticated server key, retrieve a project by ID, or delete a project.
Project management endpoints are available under /v1/projects and require a server API key. A global admin server key can work across projects, while a project-scoped server key is limited to its own project.
Schema
Project creation accepts the following fields. Project responses include these fields plus the generated identifier and timestamps.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Response only | Generated project identifier. |
key | string | Yes when creating | Unique, URL-safe project identifier. |
name | string | Yes | Project name, from 1 to 120 characters. |
description | string | No | Optional project description, up to 500 characters. Responses return null when no description is set. |
createdAt | string | Response only | Project creation timestamp. |
updatedAt | string | Response only | Time the project was last updated. |
Note:
Deleting a project cascades to its environments, flags, segments, keys, and webhooks.
Endpoints
| Method | Path | Description |
|---|---|---|
POST | /v1/projects | Create a new project that owns environments, flags, segments, keys, webhooks, and audit logs. Returns the created project. |
GET | /v1/projects | List projects visible to the authenticated server key. Admin keys list all projects; project-scoped keys list only their own project. |
GET | /v1/projects/{projectId} | Fetch a single project by its ID. |
DELETE | /v1/projects/{projectId} | Delete a project and cascade the deletion to its environments, flags, segments, keys, and webhooks. |