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

# Provider connections

> Connect, test, configure, and disconnect SERP providers over the REST API.

Paths are relative to `/api/v1`. All routes use a project-scoped API key -
`Authorization: Bearer <api_key>` - that must belong to the project in the
path. See [Authentication](/docs/docs/authentication) for scopes.

| Method   | Path                                                     | Purpose                                                |
| -------- | -------------------------------------------------------- | ------------------------------------------------------ |
| `GET`    | `/projects/{project_id}/providers`                       | List the provider catalog and connection state.        |
| `POST`   | `/projects/{project_id}/providers/{provider_id}/connect` | Encrypt and save provider credentials or settings.     |
| `POST`   | `/projects/{project_id}/providers/{provider_id}/test`    | Test credentials without saving a new connection.      |
| `PATCH`  | `/projects/{project_id}/providers/{provider_id}`         | Change enabled, primary, priority, or cost settings.   |
| `DELETE` | `/projects/{project_id}/providers/{provider_id}`         | Disconnect the provider and delete stored credentials. |

Provider-specific credential fields and fallback behavior are described in
[Integrations](/docs/docs/integrations). Secret values are accepted on writes but are
never returned by list responses.

The generated [OpenAPI document](/docs/api/v1/openapi.json) remains the
authoritative request and response schema.