/api/orgs/{org_id}/provider-connections/{provider}Disconnect a provider account
Removes exactly the account named by setup_alias, including its stored credentials. The handle is required so a default account is never removed by accident. Never needs Pro; disconnecting the last paid connection of a Free org ends its grandfathered BYOK access. The owner of an account-scoped plan may disconnect it; otherwise an org admin or the org's own key.
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.providerenumrequiredThe provider to connect.
Query parameters
setup_aliasstringrequiredThe exact account handle to remove.
Responses
200The account was removed.
Response
removedbooleanrequiredproviderenumrequiredA provider an organization can connect its own key for. kenari, kiosapi, tokenharbor, groq and nvidia_nim are free-tier providers open to every plan.
setup_aliasstringrequired
400The request is malformed or names an unsupported value.
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).
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).
404No such account in this 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 or query failed validation.
Response
detailarray<object>requireddetail
typestringlocarray<string | integer>msgstring
Request
curl -X DELETE https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/openai?setup_alias=openai-main \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"removed": true,
"provider": "openai",
"setup_alias": "openai-main"
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/openai?setup_alias=openai-main