/api/orgs/{org_id}/provider-connections/{provider}/checkCheck a provider account
Probes the stored credential at the provider and persists the verdict. A stored admin key is probed in the same pass and reported under status_detail.spend_key. Plan accounts are refused with 409 (use their refresh-usage action). No request body.
認証: AuthorizationヘッダーにBearer形式のAPIキー
パスパラメータ
org_idstring必須Your organization id (uuid).
GET /api/whoamireturns it.providerenum必須The provider to connect.
クエリパラメータ
setup_aliasstringThe account handle. Omitted, the provider-named default account.
レスポンス
200The persisted verdict.
レスポンス
providerenum必須A provider an organization can connect its own key for. kenari, kiosapi, tokenharbor, groq and nvidia_nim are free-tier providers open to every plan.
statusenum必須The provider-verified key state, written by the hookup check and by real traffic.
provider_errormeans the provider was unreachable when checked, not that the key is bad.status_detailobject | null必須Provider detail (raw code and message, remediation text).
spend_keyholds the admin key's own verdict;modelsholds per-model support facts.status_checked_atstring | null必須status_sourceenum | null必須
400The request is malformed or names an unsupported value.
レスポンス
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).
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).
409The account is a plan account, not an 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).
リクエスト
curl -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/openai/check?setup_alias=openai-main \
-H "Authorization: Bearer YOUR_API_KEY"レスポンス
{
"provider": "openai",
"status": "invalid",
"status_detail": {
"http_status": 401,
"provider_code": "invalid_api_key",
"provider_message": "Incorrect API key provided.",
"remediation": "Create a new key at platform.openai.com/api-keys and rotate this account."
},
"status_checked_at": "2026-11-19T14:10:03.551Z",
"status_source": "hookup_check"
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/openai/check?setup_alias=openai-main