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

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

`POST /v1/search-connections/{connectionId}/disconnect`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/search-connections/{connectionId}/disconnect`
- Auth: HTTP bearer

Signed-in workspace owner or administrator with discovery:write. Send an empty JSON object. Erases local provider credentials and retains saved results.

## Path parameters

- `connectionId` string, required

## Headers

- `X-Workspace-ID` string, required

## Request body

- object

## Response `200`

Signed-in workspace owner or administrator with discovery:write. Send an empty JSON object. Erases local provider credentials and retains saved results.

- object
  - `disconnected` true, required
  - `retainedRows` true, 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/1bf30c2912b2?raw)