---
title: "list_search_connections"
method: GET
path: "/v1/search-connections"
---

# list_search_connections

`GET /v1/search-connections`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/search-connections`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Required projectId goes in the query. Returns provider availability and public connection state.

## Query parameters

- `projectId` string, required: project ID from create/list.

## Headers

- `X-Workspace-ID` string

## Response `200`

Required projectId goes in the query. Returns provider availability and public connection state.

- object
  - `connections` object[], required
    - `id` string, required: Resource identifier returned by the operation.
    - `project_id` string, required: Project that owns this record.
    - `provider` 'google' | 'bing', required
    - `status` string, required: Resource lifecycle status.
    - `property` string, nullable, required
    - `last_sync_at` string, nullable, required
    - `next_sync_at` string, nullable, required
    - `last_error` string, nullable, required
    - `coverage` object, nullable, required: Dataset scope and completeness, including limits on what these results establish.
    - `snapshot_id` string, nullable, required
    - `capability` 'search_performance' | 'backlinks', required
    - `created_at` string, required: UTC timestamp when the record was created.
    - `updated_at` string, required: UTC timestamp of the last record update.
  - `providers` object[], required
    - `provider` 'google' | 'bing', required
    - `configured` boolean, required
    - `capability` 'search_performance' | 'backlinks', required

## Other responses

- `429`: Request-rate or usage refusal. Inspect error.code and recovery details before retrying.
- `default`: Error envelope. Non-configuration 5xx messages are masked and details omitted; allowlisted configuration errors retain static operator recovery.

---

[API](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api.md) · [All operations](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/revisions/2a712a1dcfa7?raw)