Canaux

Désactiver, réactiver ou renommer un canal

PATCH/v1/channels/{id}

Réactiver un canal remet à zéro sa série d’échecs (un canal en échec depuis 24 heures est désactivé automatiquement).

Authentification: Clé d’API (Authorization: Bearer)
Portée requise: write

Paramètres de chemin#

idstring · uuidobligatoire

Corps de la requête#

statestring
Valeurs active disabled
namestring
de 1 à 80 caractères

Réponses#

200Canal modifié.

Champs de l’objet

idstring · uuid
kindstring
Valeurs webhook discord slack email telegram hellome
namestringpeut valoir null
statestring
Valeurs active disabled
rolestring
Valeurs alerts escalation
targetstringpeut valoir null
Destination masquée, par exemple https://hooks.example.com/aicscan, a***@example.com.
created_atstring · date-time
disabled_atstring · date-timepeut valoir null
disabled_reasonstringpeut valoir null
last_success_atstring · date-timepeut valoir null
linked_atstring · date-timepeut valoir null

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl -X PATCH "https://aicscan.io/v1/channels/0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f" \
  -H "Authorization: Bearer $AICSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "disabled"
  }'

JavaScript

const res = await fetch('https://aicscan.io/v1/channels/0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "state": "disabled"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os
import requests

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

Réponse 200

JSON

{
  "id": "0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f",
  "kind": "webhook",
  "name": "SIEM",
  "state": "active",
  "role": "alerts",
  "target": "https://hooks.example.com/aicscan",
  "created_at": "2026-11-14T09:12:40.118Z",
  "disabled_at": null,
  "disabled_reason": null,
  "last_success_at": "2026-11-14T09:30:14.020Z",
  "linked_at": null
}