Désactiver un mot-clé

Authentification

Envoyez un token API RedReplier comme Bearer token à chaque requête. Les tokens commencent par redreplier_; RedReplier résout le compte depuis le token. Envoyez X-Workspace-Id pour agir dans un autre espace de travail que celui par défaut; voir Lister les espaces de travail.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Paramètres

• keywordId (chemin, UUID, requis): Mot-clé à désactiver.

Corps de la requête

Cet endpoint ne nécessite aucun corps JSON.

Réponse

Renvoie un objet Keyword public.

• id (string): UUID du mot-clé.
• websiteId (string): UUID du site web parent.
• value (string): Texte du mot-clé, jusqu’à 255 caractères.
• status (string): PENDING, ACTIVE, DISABLED ou SUSPENDED.
• createdAt, updatedAt (ISO string | null): Horodatages de création et de mise à jour au format ISO 8601, ou null.

Exemple de requête

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

Notes

La désactivation arrête la surveillance immédiatement et ne consomme pas le quota de modification. Désactiver un mot-clé actif libère sa place dans l’abonnement, donc le plus ancien mot-clé en attente qui y tient devient actif et sa surveillance démarre.

Erreurs

• 400 Bad Request: Entrée, URL, UUID, enum, paramètre de requête ou corps non valide.
• 401 Unauthorized: Bearer token manquant ou non valide, ou code: "token_issuer_lost_access" quand la personne qui a créé la clé API a été désactivée ou a quitté l'espace de travail.
• 403 Forbidden: code: "subscription_required" quand l'abonnement de l'espace de travail n'inclut pas l'accès à l'API, code: "workspace_access_denied" quand X-Workspace-Id désigne un espace de travail que ces identifiants ne peuvent pas atteindre, ou code: "permission_denied" quand votre rôle dans l'espace de travail n'a pas la permission redreplier.write (Admin et Editor l'ont).
• 404 Not Found: La ressource n’existe pas pour le compte du token.
• 429 Too Many Requests: Limite de débit dépassée. Attendez le nombre de secondes indiqué dans Retry-After.
• 500 Internal Server Error: Erreur serveur inattendue.