Skip to main content
GET
Get a provider
Returns one catalogued provider as a ProviderDetail: the capability chains that use it and the credential health of each connection target it authenticates through. An unresolved or invalid connection carries a person-only Console handoff naming the required action and permission. A missing key is 400; a key outside the catalog is 404. No credential identity, env-var name or option value is returned; see Credential health. The Forge Console provider reader uses the same explicit conjunction at its original platform home: audit:read AND grants:read AND policies:read. Basket credential metadata still requires credentials:read at each credential’s persisted scope. The outer read keys do not grant credential entitlement.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

providerKey
string
required

The provider key, as listProviders returns it (for example openai).

Minimum string length: 1

Response

Provider detail

data
object
required

A ProviderSummary with the capability chains that use the provider and the credential health of each connection target it authenticates through. Provider option values, credential identities and env-var names are not returned.

meta
object
required