/api/orgs/{org_id}/provider/credentialStore or rotate the provider house key
Hands the platform the key it should hold and serve your endpoint with. Write-only: the secret goes to a vault and is never returned, only its last four characters appear on the provider view. A provider on auth_mode: none switches to house_key in the same call; one already on house_key rotates. Org admin session or the org's own key; 422 for a native provider, whose credential is not a stored key.
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.
Request body
secretstringrequiredThe key your endpoint issues for the platform. Never returned.
Responses
200The updated provider row.
Response
slugstringrequireddisplay_namestringrequiredfamilyenumrequiredbase_urlstring | nullrequiredThe OpenAI-compatible base URL the gateway calls.
auth_modeenumrequiredhouse_key: the platform holds your key.none: no stored key.native: a built-in integration whose credential the platform manages.statusenumrequiredProvider lifecycle.
max_concurrencyinteger | nullrequiredadvertised_tpsnumber | nullrequireddata_policyobjectrequiredSelf-declared prompt-data handling.
retention_daysis required whenretains_promptsis true and must be omitted otherwise;zero_data_retentionrequiresretains_promptsandtrains_on_databoth false.data_policy
retains_promptsbooleanrequiredretention_daysinteger | nullDays prompts are kept.
trains_on_databooleanrequiredzero_data_retentionbooleanrequiredpolicy_urlstring | nullPublic https URL of the policy.
contactobjectrequiredcontact
emailstringrequiredWhere the platform reaches you when a lane misbehaves.
escalationstring | nullFree-form escalation instructions (pager, shared channel, phone).
status_pagestring | nullPublic https status page.
logo_urlstring | nullrequiredcredential_last4string | nullrequiredLast four characters of the stored house key. The key itself is never returned.
has_credentialbooleanrequiredstripe_account_idstring | nullrequiredLinked Stripe Connect account.
payouts_enabledbooleanrequiredWhether Stripe reports the linked account payout-ready.
401Missing, unknown or revoked API key.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
403The key is valid but may not perform this action (for example an inference key on a provisioning-key route, or a feature outside your plan).
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404The resource does not exist or belongs to another organization.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
422The body failed validation (secret shorter than 12 or longer than 4096 characters), or the provider is native.
Request
curl -X PUT https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/credential \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"secret": "sk-acme-live-3b9e0c7d1f2a4e6b8c5d9f3a"
}'Response
{
"slug": "acme-inference",
"display_name": "Acme Inference",
"family": "openai_compatible",
"base_url": "https://api.acme-inference.example/v1",
"auth_mode": "house_key",
"status": "canary",
"max_concurrency": 256,
"advertised_tps": 80,
"data_policy": {
"retains_prompts": false,
"retention_days": null,
"trains_on_data": false,
"zero_data_retention": true,
"policy_url": null
},
"contact": {
"email": "oncall@acme-inference.example",
"escalation": null,
"status_page": null
},
"logo_url": null,
"credential_last4": "9f3a",
"has_credential": true,
"stripe_account_id": null,
"payouts_enabled": false
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/credential