API-referentieDEL

Trefwoord verwijderen

Verwijder een trefwoord in elke status definitief, samen met alle vermeldingen die het heeft opgeleverd.

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

Verwijder een trefwoord in elke status definitief, samen met alle vermeldingen die het heeft opgeleverd.

Bearer-token (RedReplier API-token)

Authenticatie

Stuur bij elk verzoek een RedReplier-API-token mee als Bearer-token. Tokens beginnen met redreplier_; RedReplier leidt het account af uit het token. Stuur X-Workspace-Id mee om in een andere workspace dan de standaardworkspace te werken; zie Workspaces weergeven.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameters

  • keywordId (pad, UUID, verplicht): Trefwoord om te verwijderen, in elke status.

Request body

Dit endpoint vereist geen JSON-body.

Respons

Geeft een bevestiging van de verwijdering terug.

  • deleted (boolean): Altijd true als het verwijderen is gelukt.

Voorbeeldverzoek

curl -X DELETE https://ai.redreplier.com/ai-app/api/v1/keywords/22222222-2222-4222-8222-222222222222 \
  -H 'Authorization: Bearer redreplier_test_1234567890'

Opmerkingen

Definitief: het trefwoord en alle vermeldingen die het heeft opgeleverd worden verwijderd, ongeacht de status. Verwijder je een actief trefwoord, dan komt de plek in je abonnement vrij en wordt het oudste passende trefwoord in behandeling actief en begint het te volgen. Wil je stoppen met volgen en de vermeldingen bewaren, gebruik dan Trefwoord uitschakelen.

Fouten

  • 400 Bad Request: Ongeldige invoer, URL, UUID, enum, queryparameter of body.
  • 401 Unauthorized: Bearer-token ontbreekt of is ongeldig, of code: "token_issuer_lost_access" wanneer de persoon die de API-sleutel heeft aangemaakt is gedeactiveerd of de workspace heeft verlaten.
  • 403 Forbidden: code: "subscription_required" wanneer het abonnement van de workspace geen API-toegang bevat, code: "workspace_access_denied" wanneer X-Workspace-Id een workspace noemt waar deze inloggegevens geen toegang toe hebben, of code: "permission_denied" wanneer je rol in de workspace geen redreplier.write heeft (Admin en Editor hebben die wel).
  • 404 Not Found: De resource bestaat niet voor het account van het token.
  • 429 Too Many Requests: Rate limit overschreden. Wacht het aantal seconden uit Retry-After.
  • 500 Internal Server Error: Onverwachte serverfout.
Voorbeeldverzoek (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
}