POST/api/orgs/{org_id}/provider-connections/reorder

Reorder 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_idstringrequired

    Your organization id (uuid). GET /api/whoami returns it.

Request body

  • orderarray<object>required

    Every account of the org, in the desired order.

    order
    • providerenumrequired

      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.

      "openai""anthropic""azure_openai""openrouter""gemini""bedrock""fireworks""modal""vertex""zai""qwen""tencent""meta""cerebras""wafer""huawei""mistral""dashscope""xai""deepseek""typesafe""kenari""kiosapi""tokenharbor""groq""nvidia_nim"
    • setup_aliasstringrequired

Responses

  • 200

    The routing state of every account in the new order.

    Response
    • accountsarray<object>required
      accounts
      • providerstringrequired
      • setup_aliasstringrequired
      • priorityintegerrequired
      • exhaustion_fallbackbooleanrequired
      • ratelimit_failoverbooleanrequired
      • failover_only_onarray | nullrequired
  • 400

    An account is missing from the order, appears twice, or names an unknown provider.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 403

    The 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
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    The resource does not exist or belongs to another organization.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    The body or query failed validation.

    Response
    • detailarray<object>required
      detail
      • typestring
      • locarray<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