> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM providers

> Activate LLM providers, set base URL and adapter, test the connection, rotate the API key or OAuth client secret, and trigger a model sync.

**LLM Providers** (`/platform/providers`) lists the access channels Forge uses for LLM inference: each provider's base URL, adapter kind, and default credential. It is the **Providers** tab of the **Models** sidebar entry, between **Catalog** and **Fallback Chains**. Open it when a provider's models stop syncing, when a credential needs rotating, or to switch a provider on or off.

![LLM providers (light)](https://mintcdn.com/gloo-b243725a/Ndtg9NEpwGc2OULA/forge/images/console/platform/providers-light.png?fit=max\&auto=format\&n=Ndtg9NEpwGc2OULA\&q=85\&s=3c25cf7b8c5c0226781d7cff09ee43a3)

LLM providers — Forge Console at `/platform/providers`

## What you can do

* **Sync models now** schedules a model sync across providers. The header then shows "Sync scheduled — models will update shortly." or the failure message.
* Toggle a provider card's switch to activate or deactivate it. A provider without a credential cannot be switched on; the toggle shows "Configure key first".
* **Edit** opens a drawer with **Display name**, **Description**, **Base URL**, **Adapter** (`anthropic-sdk`, `openai-compatible`, `gloo-oauth`, `aws-bedrock`), **UI order hint**, and **Active**. Its **Test connection** section has a **Test** button: with an API key it probes `GET /models`; with OAuth it fetches a fresh token from the token URL, then probes `GET /models`.
* **Rotate secret** overwrites the provider's encrypted default secret. API-key providers take an **API key**; OAuth providers take **Client ID**, **Client secret**, **OAuth token URL**, and **OAuth scope**. The plaintext is encrypted server-side before storage, and per-scope overrides in `virtualKeys` are unaffected.

## Card fields

| Field | Meaning |
| - | - |
| **adapter** | The adapter kind that speaks to the provider |
| **credential** | `api_key` or `oauth_client_credentials` |
| **base url** | The endpoint Forge calls |
| **last sync** | Time since the last model sync and the model count, or `never` |

The three stat cards count **Providers**, **Active** providers, and **Credentials configured**.

## Credential badges

| Badge | Meaning |
| - | - |
| **key configured** | An API key is stored |
| **no key** | API-key provider with no key |
| **oauth ready** | OAuth client secret stored and a current access token |
| **token expired** | OAuth access token has expired |
| **awaiting token** | OAuth client secret stored, no token fetched yet |
| **no client secret** | OAuth provider with no client secret |

## Who can act

The page reads with `platform:read`. **Edit**, **Rotate secret**, and the active toggle are enabled only for admins, and the writes and **Sync models now** require `gateway:manage` on the server.

## Key state to watch

* **no key**, **no client secret**, or **token expired** on an active provider: rotate the secret, then run **Test**.
* A sync error printed under a card's fields: the last model sync for that provider failed; check the base URL and credential, then **Sync models now**.
* **last sync** of `never` on an active provider: its models have not reached the catalog.
* **Active** lower than you expect: every fallback chain that lists a model from an inactive provider flags that model **provider disabled**.

## Related surfaces

* [Models](https://docs.gloo.com/forge/console/platform/models)
* [Fallback Chains](https://docs.gloo.com/forge/console/platform/fallback-chains.md)
* [LLM routing](https://docs.gloo.com/forge/console/observe/llm-routing.md)
* [Capability providers](https://docs.gloo.com/forge/console/platform/capability-providers.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.