Upsert Provider
Path Parameters
Header Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Body of PUT /providers/{layer} — save and activate one provider.
A partial write. Fields you omit keep the value already saved for this
(layer, provider) pair: omit api_key to edit params without
resending the key, send only the params keys you want to change,
and omit fallback_enabled to leave the flag as it is. The merged
result is what gets validated against the layer's schema (422 on a
mismatch), so a partial write can never leave an invalid config behind.
Rows are keyed by (organization, layer, provider), so writing a
different provider for the same layer starts from scratch rather than
inheriting the previous provider's params. On a brand-new row
fallback_enabled defaults to false.
Keys are write-only: no response ever echoes one back.
Response Body
application/json
application/json
curl -X PUT "https://example.com/v1/providers/string" \ -H "Content-Type: application/json" \ -d '{ "provider": "string" }'{ "layer": "llm", "provider": "string", "key_last4": "string", "key_set_at": "string", "params": {}, "fallback_enabled": true, "is_active": true}Upload Sms Evidence
Upload a consent screenshot and get back a public link. Put the returned `url` in an SMS registration field that asks for an evidence URL (for example `website_evidence_url`). Carrier reviewers open it without signing in, so anyone with the link can see the file. Remove personal information first. Pasting your own public link still works.
Validate Provider
Probe a provider key against the real provider. Empty body tests the layer's active provider with its stored key; send ``provider`` to test a specific saved row, or ``api_key`` (plus ``provider``/``params``) to test a key before saving it.