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

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

`DELETE /v1/search-connections/{connectionId}`

## Request

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

Signed-in workspace owner or administrator with discovery:write. Send confirmation exactly as forget connection followed by a space and this connectionId. Removes the connection and saved provider rows.

## Path parameters

- `connectionId` string, required

## Headers

- `X-Workspace-ID` string, required

## Request body

- object
  - `confirmation` string, required

## Response `200`

Signed-in workspace owner or administrator with discovery:write. Send confirmation exactly as forget connection followed by a space and this connectionId. Removes the connection and saved provider rows.

- object
  - `forgotten` 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/2a712a1dcfa7?raw)