API Reference
OIDC
Platform

Managed Waf

AdminUpdated Sep 11, 2026

Managed Waf

Backend API — secret key (Authorization: Bearer sk_…).

5 routes. Each row is one endpoint with its explanation, required scope, and whether it honours the Idempotency-Key header.

Method & path

Scope

Idem

Explanation

GET /v1/managed_waf

managed_waf:read

Read the managed AWS WAF configuration and provisioning state. AWS credential secrets are never returned, only has_* markers.

GET /v1/managed_waf/status

managed_waf:read

Read just the managed AWS WAF provisioning state: status, WebACL id/arn, last error and last-provisioned time.

PUT /v1/managed_waf

managed_waf:write

Configure the managed AWS WAF: scope/region, edge target, token domains, gated paths, and the write-only BYO AWS credentials. Enabling points auth_config.captcha at awswaf.

POST /v1/managed_waf/provision

managed_waf:write

Provision now: idempotently create-or-update the AWS WAF WebACL with the CAPTCHA rule and associate it with the edge (ALB or CloudFront). Fail-safe: AWS errors are recorded, not thrown into auth.

POST /v1/managed_waf/deprovision

managed_waf:write

Deprovision: disassociate the WebACL from the edge and delete it, then clear the stored state. Fail-safe like provision.

Was this page helpful?