---
title: "Disable AI Referrals Connection"
method: DELETE
path: "/{brand_id}/ai-referrals/connections/{connection_id}"
tags: ["ai-referrals"]
---

# Disable AI Referrals Connection

`DELETE /{brand_id}/ai-referrals/connections/{connection_id}`

## Request

- Base URL: `https://api.scrunchai.com/v1`
- URL: `https://api.scrunchai.com/v1/{brand_id}/ai-referrals/connections/{connection_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/scrunch/apis/scrunch-data-api/docs/:brand_id/ai-referrals/connections/:connection_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Soft-disable a connection. Previously pushed events are retained but further pushes are rejected with `410 Gone` and the dashboard stops reading from this connection.

## Path parameters

- `brand_id` integer, required
- `connection_id` string, required

## Response `200`

Connection disabled.

- AiReferralsConnection: A registered AI Referrals push connection.
  - `id` string, required: ULID identifier for the connection.
  - `brand_id` integer, required
  - `website` string, required: Hostname or URL of the website whose referrals are pushed against this connection.
  - `provider` 'custom' | 'adobe_analytics', required: Where the data comes from: "custom" for any analytics tool, or "adobe_analytics". Both are read the same way.
  - `status` 'active' | 'disabled', required
  - `created_at` string, date-time, required
  - `last_pushed_at` string, date-time, nullable
  - `last_push_error` string, nullable
  - `sends_engagement` boolean: Whether the connection's rows carry users, engagement and key events. Set by its first push.

## Other responses

- `404`: Connection not found for this brand, or the AI Referrals API isn't enabled for it.
- `422`: Validation Error

## Changes

- **2026-11-05** `3c6aa69a6595`: 2 warning, 1 info
  - added the new `adobe_analytics` enum value to the `provider` response property for the response status `200`
  - added the new `custom` enum value to the `provider` response property for the response status `200`
  - added the optional property `sends_engagement` to the response with the `200` status

[Operation history](https://skmtc.dev/scrunch/apis/scrunch-data-api/changes/:brand_id/ai-referrals/connections/:connection_id/delete.md)

---

[API](https://skmtc.dev/scrunch/apis/scrunch-data-api.md) - [All operations](https://skmtc.dev/scrunch/apis/scrunch-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrunch/apis/scrunch-data-api/revisions/e28a10a186bf?raw)