Référence de l'APIPATCH

Modifier un mot-clé

Modifie le texte d’un mot-clé existant.

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

Modifie le texte d’un mot-clé existant.

Jeton Bearer (jeton API RedReplier)

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.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Paramètres

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

Corps de la requête

  • value (string, requis, max 255): Nouveau texte du mot-clé.

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 PATCH https://ai.redreplier.com/ai-app/api/v1/keywords/22222222-2222-4222-8222-222222222222 \
  -H 'Authorization: Bearer redreplier_test_1234567890' \
  -H 'Content-Type: application/json' \
  -d '{"value":"agency CRM recommendations"}'

Notes

Modifier des mots-clés actifs peut compter dans le quota mensuel de modification. Modifier un mot-clé SUSPENDED est la méthode normale pour corriger des termes trop bruyants.

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.
  • 404 Not Found: La ressource n’existe pas pour le compte du token.
  • 500 Internal Server Error: Erreur serveur inattendue.
Exemple de requête (curl)
curl --request PATCH \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d \
  --header 'Authorization: Bearer redreplier_test_1234567890' \
  --header 'Content-Type: application/json' \
  --data '{"value": "CRM for agencies"}'
200
{
  "id": "73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d",
  "websiteId": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
  "value": "agency CRM",
  "status": "ACTIVE",
  "createdAt": "2026-05-22T10:16:00.000Z",
  "updatedAt": "2026-05-29T14:02:11.000Z"
}