---
title: "Signed-in workspace owner or administrator with discovery:write"
method: POST
path: "/v1/search-connections/start"
---

# Signed-in workspace owner or administrator with discovery:write

`POST /v1/search-connections/start`

## Request

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

Signed-in workspace owner or administrator with discovery:write. Returns the provider sign-in URL and sets an HttpOnly browser-binding cookie; the browser completes consent.

## Headers

- `X-Workspace-ID` string, required

## Request body

- object
  - `projectId` string, required
  - `provider` 'google' | 'bing', required

## Response `200`

Signed-in workspace owner or administrator with discovery:write. Returns the provider sign-in URL and sets an HttpOnly browser-binding cookie; the browser completes consent.

- object
  - `authorizationUrl` string, uri, required
  - `expiresAt` string, 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)