Trefwoord verwijderen
Verwijder een trefwoord in elke status definitief, samen met alle vermeldingen die het heeft opgeleverd.
https://ai.redreplier.com/ai-app/api/v1/keywords/{keywordId}Verwijder een trefwoord in elke status definitief, samen met alle vermeldingen die het heeft opgeleverd.
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/jsonParameters
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): Altijdtrueals 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, ofcode: "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"wanneerX-Workspace-Ideen workspace noemt waar deze inloggegevens geen toegang toe hebben, ofcode: "permission_denied"wanneer je rol in de workspace geenredreplier.writeheeft (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 uitRetry-After.500 Internal Server Error: Onverwachte serverfout.
curl --request DELETE \
--url https://ai.redreplier.com/ai-app/api/v1/keywords/73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d \
--header 'Authorization: Bearer redreplier_test_1234567890'{
"deleted": true
}