GET/api/orgs/{org_id}/provider-connections

List provider connections

Every bring-your-own-key account of the organization, several per provider when the org connected more than one. Returns non-secret config and the last four characters of each credential; the secret itself is never returned. Any member, or the org's own key, may read.

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

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

Responses

  • 200

    The org's connections.

    Response
    • 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

      Account handle; the default account's handle is the provider name.

    • configobjectrequired

      Non-secret provider config.

    • credential_last4string | nullrequired
    • spend_credential_last4string | nullrequired

      Last four of the stored admin key, if any.

    • statusenumrequired

      The provider-verified key state, written by the hookup check and by real traffic. provider_error means the provider was unreachable when checked, not that the key is bad.

      "unchecked""valid""invalid""rate_limited""quota_exhausted""provider_error"
    • priorityintegerrequired

      Position in the org's account pool; lower is tried first.

    • exhaustion_fallbackbooleanrequired

      Whether the pool rotates past this account when it is quota_exhausted.

    • ratelimit_failoverbooleanrequired

      Whether the pool rotates past this account while it is rate limited.

    • failover_only_onarray | nullrequired

      Null for unrestricted; a list makes the account a fallback for exactly those failures.

  • 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).

  • 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).

Request

curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

[
  {
    "provider": "openai",
    "setup_alias": "openai",
    "config": {},
    "credential_last4": "x9Qa",
    "spend_credential_last4": null,
    "status": "valid",
    "priority": 0,
    "exhaustion_fallback": true,
    "ratelimit_failover": true,
    "failover_only_on": null
  },
  {
    "provider": "bedrock",
    "setup_alias": "bedrock-eu",
    "config": {
      "region": "eu-central-1",
      "auth_mode": "access_key_pair",
      "access_key_id": "AKIAEXAMPLE7Q2LZ4KD"
    },
    "credential_last4": "f3Rk",
    "spend_credential_last4": null,
    "status": "rate_limited",
    "priority": 1,
    "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