/api/orgs/{org_id}/provider-connections/{provider}/accounts/{setup_alias}/routingSet provider account routing
Partial patch: only fields present in the body are written; at least one is required (400). failover_only_on makes the account a fallback for exactly the listed failures (its rungs are never dialled first); it is refused with 422 unless some model Waterfall of the org already places this account below another rung. Takes effect on the next gateway refresh. Never needs Pro.
認証: AuthorizationヘッダーにBearer形式のAPIキー
パスパラメータ
org_idstring必須Your organization id (uuid).
GET /api/whoamireturns it.providerenum必須The provider to connect.
setup_aliasstring必須The account handle.
リクエストボディ
priorityinteger | nullPool position; lower is tried first.
exhaustion_fallbackboolean | nullratelimit_failoverboolean | nullfailover_only_onarray | nullOmitted leaves it unchanged; null resets to unrestricted; a non-empty list restricts the account to those failures.
レスポンス
200The account's routing state after the write.
レスポンス
providerstring必須setup_aliasstring必須priorityinteger必須exhaustion_fallbackboolean必須ratelimit_failoverboolean必須failover_only_onarray | 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).
422Unknown or empty
failover_only_on, an unknown field, or fallback rules on an account no Waterfall places below another rung (anErrorbody in that last case).
リクエスト
curl -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/openai/accounts/bedrock-eu/routing \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"priority": 2,
"failover_only_on": [
"throttled",
"provider_quota"
]
}'レスポンス
{
"provider": "bedrock",
"setup_alias": "bedrock-eu",
"priority": 2,
"exhaustion_fallback": true,
"ratelimit_failover": true,
"failover_only_on": [
"throttled",
"provider_quota"
]
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/openai/accounts/bedrock-eu/routing