Channels

Delete a channel

DELETE/v1/channels/{id}

Soft delete (delivery history is kept); the channel no longer counts in the plan limits. Refused with 409 channel_in_use while an active rule uses it. Workspace owners and the other active channels are notified.

Authentication: API key (Authorization: Bearer)
Required scope: write

Path parameters#

idstring · uuidrequired

Responses#

204Deleted.

4xx · 5xxError.

Standard error format: see Errors.

Request

cURL

curl -X DELETE "https://aicscan.io/v1/channels/0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/channels/0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
  },
});
if (!res.ok) throw new Error((await res.json()).error.code);
console.log(res.status); // 204

Python

import os
import requests

resp = requests.delete(
    "https://aicscan.io/v1/channels/0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.status_code)  # 204

Response 204

No response body.