Projects
Projects are the top-level organizational boundary. Each project has its own workspaces, blueprints, tenants, and API keys.
GET /projects
List all projects for the authenticated customer.
HTTP 200
{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "count": 2,
  "projects": [
    {
      "project_id": "tdb_2abf90d3",
      "name": "Healthcare SaaS",
      "api_key_count": 2,
      "created_at": "2026-01-17T20:12:06Z"
    },
    {
      "project_id": "tdb_43cd4942",
      "name": "E-commerce Platform",
      "api_key_count": 1,
      "created_at": "2026-01-17T20:12:24Z"
    }
  ]
}
POST /projects
Create a new project. Returns a new API key.
Request Body
FieldTypeDescription
name string required Project name
Response
HTTP 201
{
  "success": true,
  "http_status": 201,
  "code": "created",
  "project_id": "tdb_43cd4942",
  "name": "E-commerce Platform",
  "api_key": "tenantsdb_sk_42d5be1a...",
  "proxy_password": "tdb_a9b55759ef905535",
  "message": "Project created. Save your API key - it won't be shown again!"
}
POST /projects/{id}/switch
Switch to a different project. Returns the API key for the target project. Accepts project ID or project name.
Response
HTTP 200
{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "project_id": "tdb_43cd4942",
  "name": "E-commerce Platform",
  "api_key": "tenantsdb_sk_42d5be1a...",
  "proxy_password": "tdb_a9b55759ef905535"
}
DELETE /projects/{id}
Delete a project and all its resources (workspaces, blueprints, tenants, API keys).
Response
HTTP 200
{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "Project 'tdb_43cd4942' deleted successfully"
}
API Keys
Manage API keys for the current project.
GET /apikeys
List all API keys for the current project.
POST /apikeys
Generate a new API key. Returns HTTP 201.
DELETE /apikeys/{id}
Delete an API key.