Path Parameters
Header Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Body of POST /providers/{layer}/validate — a live key probe.
All fields optional: with an empty body the layer's active provider and
its stored key are tested. provider tests that provider's stored key
instead. api_key tests a key that has not been saved yet.
Response Body
application/json
application/json
curl -X POST "https://example.com/providers/string/validate" \ -H "Content-Type: application/json" \ -d '{}'{ "status": "string", "message": "string"}Upsert Provider
Save a provider for ``layer`` and make it the active one. A partial write: anything you omit keeps its saved value. Omitting ``api_key`` keeps the stored key, ``params`` keys you don't send are preserved, and omitting ``fallback_enabled`` leaves the flag alone (``false`` on a new row). The merged result — not the partial input — is validated against the layer's schema (422 on a mismatch). 404 on an unknown layer.
Verify Email Domain
Re-poll the email provider for the current verification status. On-demand only — there is no background poller in v1. Operators / tenants hit this after publishing DNS to flip the row to ``verified``. Hail-mail rows are no-ops (they're already verified by construction).