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.

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • org_idstring必須

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

レスポンス

  • 200

    The org's connections.

    レスポンス
    • 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.

      "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_aliasstring必須

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

    • configobject必須

      Non-secret provider config.

    • credential_last4string | null必須
    • spend_credential_last4string | null必須

      Last four of the stored admin key, if any.

    • statusenum必須

      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"
    • priorityinteger必須

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

    • exhaustion_fallbackboolean必須

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

    • ratelimit_failoverboolean必須

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

    • failover_only_onarray | null必須

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

  • 401

    Missing, unknown or revoked API key.

    レスポンス
    • errorstring必須

      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.

    レスポンス
    • errorstring必須

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

リクエスト

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

レスポンス

[
  {
    "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