API-ReferenzDEL

Keyword löschen

Löscht ein Keyword in jedem Status dauerhaft, zusammen mit allen Mentions, die es gefunden hat.

DELETEhttps://ai.redreplier.com/ai-app/api/v1/keywords/{keywordId}

Löscht ein Keyword in jedem Status dauerhaft, zusammen mit allen Mentions, die es gefunden hat.

Bearer-Token (RedReplier-API-Token)

Parameter

  • keywordId (Pfad, UUID, erforderlich): Keyword, das gelöscht wird, in jedem Status.

Request-Body

Dieser Endpoint benötigt keinen JSON-Body.

Antwort

Gibt eine Löschbestätigung zurück.

  • deleted (boolean): Immer true, wenn das Löschen erfolgreich war.

Hinweise

Endgültig: Das Keyword und alle Mentions, die es gefunden hat, werden gelöscht, egal in welchem Status. Ein aktives Keyword zu löschen gibt seinen Platz im Tarif frei, und das älteste ausstehende Keyword, das hineinpasst, wird aktiv und startet das Monitoring. Um das Monitoring zu stoppen und die Mentions zu behalten, nutzen Sie stattdessen Keyword deaktivieren.

Fehler

  • 400 Bad Request: Ungültige Eingabe, URL, UUID, Enum, Query-Parameter oder Body.
  • 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token, oder code: "token_issuer_lost_access", wenn die Person, die den API-Schlüssel erstellt hat, deaktiviert wurde oder den Workspace verlassen hat.
  • 403 Forbidden: code: "subscription_required", wenn der Tarif des Workspace keinen API-Zugang enthält, code: "workspace_access_denied", wenn X-Workspace-Id einen Workspace nennt, den diese Zugangsdaten nicht erreichen, oder code: "permission_denied", wenn Ihre Rolle im Workspace die Berechtigung redreplier.write nicht hat (Admin und Editor haben sie).
  • 404 Not Found: Die Ressource existiert nicht für das Token-Konto.
  • 429 Too Many Requests: Rate-Limit überschritten. Warten Sie die Sekunden aus Retry-After ab.
  • 500 Internal Server Error: Unerwarteter Serverfehler.
Beispielanfrage (curl)
curl --request DELETE \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "deleted": true
}