A2A — Providers

The providers method namespace manages the LLM provider credentials wired into your CleverThis workspace. Adding a provider makes its models available in the workspace Library. Removing a provider stops all traffic to it and removes its models from the callable model list.

Provider credentials are encrypted at rest and never returned in API responses. You can verify that a provider is configured by calling providers.list — the credential value is always masked.

Methods

providers.list

Lists all configured providers in the workspace.

Returns: Array of provider objects:

[
  {
    "id": "prov_abc123",
    "name": "openai",
    "display_name": "OpenAI",
    "status": "active",
    "models_available": 12,
    "created_at": "2024-01-01T00:00:00Z"
  }
]

providers.add

Configures a new LLM provider.

Params:

Param	Type	Required	Description
name	string	yes	Provider name: openai, anthropic, google, mistral, groq, together, custom
api_key	string	yes	The provider's API key
base_url	string	no	Custom base URL (required for custom providers or self-hosted models)

providers.remove

Removes a provider configuration. Active deployments that depend on this provider are stopped.

Params: { "id": "prov_abc123" }

providers.update

Rotates the API key for an existing provider without interrupting service.

Params: { "id": "prov_abc123", "api_key": "new-key-value" }

Coming soon

Per-provider rate limit configuration and provider health monitoring endpoints are being added.