/api/orgs/{org_id}/provider-connections/reorderReorder provider accounts
Assigns priority = index to every account of the org in one atomic write (lower is tried first). The order must list every current account exactly once across all providers: a missing account or a duplicate is 400, an unknown one 404, and nothing is written. Never needs Pro.
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.
Request body
orderarray<object>requiredEvery account of the org, in the desired order.
order
providerenumrequiredA 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
Responses
200The routing state of every account in the new order.
Response
accountsarray<object>requiredaccounts
providerstringrequiredsetup_aliasstringrequiredpriorityintegerrequiredexhaustion_fallbackbooleanrequiredratelimit_failoverbooleanrequiredfailover_only_onarray | nullrequired
400An account is missing from the order, appears twice, or names an unknown provider.
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).
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 or query failed validation.
Response
detailarray<object>requireddetail
typestringlocarray<string | integer>msgstring
Request
curl -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/reorder \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"order": [
{
"provider": "anthropic",
"setup_alias": "anthropic"
},
{
"provider": "openai",
"setup_alias": "openai-main"
},
{
"provider": "bedrock",
"setup_alias": "bedrock-eu"
}
]
}'Response
{
"accounts": [
{
"provider": "anthropic",
"setup_alias": "anthropic",
"priority": 0,
"exhaustion_fallback": true,
"ratelimit_failover": true,
"failover_only_on": null
},
{
"provider": "openai",
"setup_alias": "openai-main",
"priority": 1,
"exhaustion_fallback": true,
"ratelimit_failover": true,
"failover_only_on": null
},
{
"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/reorder