/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.
認証: AuthorizationヘッダーにBearer形式のAPIキー
パスパラメータ
org_idstring必須Your organization id (uuid).
GET /api/whoamireturns it.
リクエストボディ
secretstring必須The key your endpoint issues for the platform. Never returned.
レスポンス
200The updated provider row.
レスポンス
slugstring必須display_namestring必須familyenum必須base_urlstring | null必須The OpenAI-compatible base URL the gateway calls.
auth_modeenum必須house_key: the platform holds your key.none: no stored key.native: a built-in integration whose credential the platform manages.statusenum必須Provider lifecycle.
max_concurrencyinteger | null必須advertised_tpsnumber | null必須data_policyobject必須Self-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_promptsboolean必須retention_daysinteger | nullDays prompts are kept.
trains_on_databoolean必須zero_data_retentionboolean必須policy_urlstring | nullPublic https URL of the policy.
contactobject必須contact
emailstring必須Where 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 | null必須credential_last4string | null必須Last four characters of the stored house key. The key itself is never returned.
has_credentialboolean必須stripe_account_idstring | null必須Linked Stripe Connect account.
payouts_enabledboolean必須Whether Stripe reports the linked account payout-ready.
401Missing, unknown or revoked API key.
レスポンス
errorstring必須Human-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).
レスポンス
errorstring必須Human-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.
レスポンス
errorstring必須Human-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.
リクエスト
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"
}'レスポンス
{
"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