Projects API reference
The Projects API is part of the Thalassa Cloud platform API. Full OpenAPI definitions are available in the API reference.
Projects require the projects feature gate. See Availability and prerequisites.
Required headers
| Header | Projects API | Resource APIs |
|---|---|---|
Authorization | Yes | Yes |
X-Organisation-Identity | Yes | Yes |
X-Project-Identity | No | Optional |
Project resolution order on resource APIs: OIDC claim project → X-Project-Identity → ?project= query parameter.
Endpoints
Base path: /v1/projects
| Method | Path | Description |
|---|---|---|
GET | /v1/projects | List projects (filtered by caller’s access) |
POST | /v1/projects | Create project |
GET | /v1/projects/{identity} | Get project |
PUT | /v1/projects/{identity} | Update project (name, description, parent) |
DELETE | /v1/projects/{identity} | Delete project |
Creating a project provisions default system IAM policies, binds the creator to the admin policy, and syncs replicated policies from ancestor projects when a parent is set.
Common response codes
| HTTP | Meaning |
|---|---|
403 | projects feature gate disabled; insufficient permission |
400 | Validation error; parent cycle; project has dependent resources |
404 | Project or parent not found |
409 | Duplicate project slug |
Related documentation
- Projects — Hierarchy, prerequisites, and project context
- IAM policies API reference — IAM policy endpoints
- IAM policies — Project-scoped access control