Deployments
Deploy blueprint schema changes to tenant databases. Runs DDL migrations across all or selected tenants.
GET /deployments
List all deployment jobs.
Response
JSON
{
  "deployments": [
    {
      "id": "dep_abc123",
      "blueprint_name": "main",
      "version": 3,
      "status": "completed",
      "tenants_total": 12,
      "tenants_completed": 12,
      "created_at": "2025-02-01T10:00:00Z"
    }
  ],
  "count": 1
}
POST /deployments
Create a new deployment.
Request Body
FieldTypeDescription
blueprint_name string required Blueprint to deploy
version string optional Version to deploy
deploy_all boolean optional Deploy to all tenants
GET /deployments/{id}
Get deployment status and progress.
Response
JSON
{
  "id": "dep_abc123",
  "blueprint_name": "main",
  "version": 3,
  "status": "in_progress",
  "tenants_total": 12,
  "tenants_completed": 8,
  "tenants_failed": 0,
  "results": [
    { "tenant_id": "acme", "status": "completed", "duration": "120ms" },
    { "tenant_id": "globex", "status": "pending" }
  ],
  "created_at": "2025-02-01T10:00:00Z"
}