Skip to main content

Provider Configuration

The provider always requires:

  • base_url
  • token

For the main path, point base_url at the page or custom domain you want to manage and use a page-admin API token.

Provider block​

provider "statuspage" {
  base_url = "https://status.example.com"
  token    = var.statuspage_token
}

Environment variables​

The provider also supports these environment variables:

  • STATUSPAGE_BASE_URL
  • STATUSPAGE_TOKEN

Scoped API behavior​

The provider client targets host-native /api/v1/admin/... and /api/v1/org/... routes when base_url points at a page or custom domain. That behavior is implemented in terraform-provider/internal/provider/client.go.

On hosted tenants, page-admin write routes are rate-limited as authenticated admin traffic. The current backend default is 120 write requests per minute, per authenticated principal and route, and 429 responses include Retry-After so callers can back off cleanly.

Dedicated Terraform API key​

The application includes a Terraform workspace in the admin UI that creates and rotates a dedicated terraform-key API token for the selected page. That workflow is implemented in application/frontend/src/pages/admin/TerraformWorkspace.jsx.