Skip to main content

Provider Configuration

The provider always requires:

  • base_url
  • token
  • organization_id

status_page_id is required for page-scoped resources and data sources, and can be omitted for organization-scoped RBAC resources.

These requirements are enforced in terraform-provider/internal/provider/provider.go.

Provider block​

provider "statuspage" {
  base_url        = "https://your-statibeat-host"
  token           = var.statuspage_token
  organization_id = 1
  status_page_id  = 1
}

Environment variables​

The provider also supports these environment variables:

  • STATUSPAGE_BASE_URL
  • STATUSPAGE_TOKEN
  • STATUSPAGE_ORG_ID
  • STATUSPAGE_PAGE_ID

Scoped API behavior​

The provider client targets:

  • organization-admin paths when a resource is organization-scoped
  • page-admin paths when a resource is page-scoped

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.