Docs
OverviewGuidesZero & MCPAPI referenceChangelog
Providers

Delete Provider

Remove the override (and its stored credentials): the server's env default serves this workspace again.

API key access

Needs the admin scope with an API key (ro_pat_...). A signed-in session uses the caller's role.
DELETE/api/v1/settings/providers/{kind}

Authorization

AuthorizationBearer <token>

Access token from /api/v1/auth/login, or an API key (ro_pat_..., RO-176) from /api/v1/workspaces/current/api-keys: the key implies its workspace and needs the route's scope. MCP connectors (/api/v1/mcp only) may use an OAuth access token (ro_oat_..., RO-284).

In: header

Path Parameters

kindProviderKind

A kind of provider a workspace can override.

Value in"llm" | "embedding" | "search" | "stt" | "tts" | "voice_llm" | "dialer" | "enrichment" | "mail"

Header Parameters

X-Workspace-Id?string | null

Id of the workspace to act on (must be a member).

Response Body

curl -X DELETE "http://localhost:8000/api/v1/settings/providers/llm" \  -H "X-Workspace-Id: string"
Empty
Empty
Empty
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Schedule Workspace Deletion

Schedule the deletion of this workspace and everything in it, `PRIVACY_DELETION_GRACE_DAYS` (default 7) from now; cancellable until then. Confirm with the workspace's slug. The owner only, signed in (API keys get 403).

List Providers

Every provider kind (language model, embeddings, web search, speech to text, text to speech, voice agent model, telephony, enrichment): the providers it can use, the server's env default and this workspace's override. Resolution: workspace override, else the env default. Credentials are never returned (`credentials_configured`). Owners and admins.