Provisioning Endpoints

The provisioning endpoints provide visibility into the asynchronous tenant provisioning process, including real-time status streaming, step details, retry capabilities, and rollback. Served by ProvisioningController at /api/v1/tenants/:tenantId/provisioning.

Endpoints

Method	Endpoint	Description
GET	`.../provisioning/status`	Get provisioning status
GET	`.../provisioning/status/detailed`	Get detailed status with phases
GET	`.../provisioning/status/stream`	SSE stream for real-time updates
GET	`.../provisioning/phases`	Get phase breakdown
GET	`.../provisioning/timeline`	Get timeline and durations
GET	`.../provisioning/events`	Get recent events
GET	`.../provisioning/steps`	Get all provisioning steps
GET	`.../provisioning/steps/:stepId`	Get step details
POST	`.../provisioning/retry`	Retry from last failed step
POST	`.../provisioning/rollback`	Rollback all resources
POST	`.../provisioning/reprovision`	Full reprovision (rollback + start)

Real-Time Status Stream

The SSE endpoint provides real-time provisioning updates every 2 seconds:

GET /api/v1/tenants/:tenantId/provisioning/status/stream
Accept: text/event-stream

Events:

Event	Description
`status`	Periodic status update with full detail
`complete`	Final event when provisioning finishes or fails

The stream has a 30-minute timeout and auto-completes when provisioning reaches COMPLETED or FAILED state.

Detailed Status Response

The detailed status includes phase breakdown, timeline, estimates, and resource summary:

{
  "progress": {
    "status": "IN_PROGRESS",
    "percentComplete": 45,
    "currentPhase": "DATA_PLANE",
    "currentStep": "DEPLOY_QUERY_ENGINE"
  },
  "phases": [
    {
      "name": "INFRASTRUCTURE",
      "status": "COMPLETED",
      "steps": 5,
      "completedSteps": 5
    }
  ],
  "timeline": {
    "startedAt": "2026-02-12T10:00:00Z",
    "estimatedCompletionAt": "2026-02-12T10:15:00Z",
    "elapsedSeconds": 420
  },
  "recentEvents": []
}

Retry and Rollback

Retry (POST .../retry): Resumes provisioning from the last failed step. Returns 400 if no steps are in a failed state.

Rollback (POST .../rollback): Reverses all provisioned resources in the opposite order of provisioning.

Reprovision (POST .../reprovision): Performs a full rollback followed by a fresh provisioning start.

All three operations return 202 Accepted with the updated provisioning status.

Tenant Endpoints Migration Endpoints