Projects API
Create, list, get, update, and delete projects.
Projects are containers within an organization for assets, folders, widgets, and API keys. All endpoints require JWT authentication.
Create project
POST
/api/organizations/{orgId}/projectsJWTRequest body
| Name | Type | Default | Description |
|---|---|---|---|
name* | string | — | Project display name |
slug* | string | — | URL-friendly identifier, unique within the organization |
Request
{
"name": "My App",
"slug": "my-app"
}Response 201
Response
{
"id": "770e8400-e29b-41d4-a716-446655440000",
"organizationId": "660e8400-e29b-41d4-a716-446655440000",
"name": "My App",
"slug": "my-app",
"createdAt": "2026-01-15T10:30:00",
"updatedAt": "2026-01-15T10:30:00"
}List projects
GET
/api/organizations/{orgId}/projectsJWTResponse 200
Returns an array of project objects.
Get project
GET
/api/projects/{projectId}JWTPath parameters
| Name | Type | Default | Description |
|---|---|---|---|
projectId* | UUID | — | Project ID |
Response 200
Returns the project object.
Update project
PUT
/api/projects/{projectId}JWTRequest body
| Name | Type | Default | Description |
|---|---|---|---|
name* | string | — | Updated project name |
Response 200
Returns the updated project object.
Delete project
DELETE
/api/projects/{projectId}JWTResponse 204
No content. The project and all its resources are deleted.
Deleting a project permanently removes all its assets, folders, widgets, and API keys. This action cannot be undone.