Référence de l'APIPATCH

Mettre à jour un site web

Met à jour le nom affiché ou la description utilisée pour le score de pertinence.

PATCHhttps://ai.redreplier.com/ai-app/api/v1/websites/{websiteId}

Met à jour le nom affiché ou la description utilisée pour le score de pertinence.

Jeton Bearer (jeton API RedReplier)

Paramètres

  • websiteId (chemin, UUID, requis): Site web à mettre à jour.

Corps de la requête

  • name (string, facultatif): Nouveau nom affiché.
  • description (string, facultatif, max 5000): Nouvelle description utilisée pour le score de pertinence.

Réponse

Renvoie un objet Website public.

Objet Website

  • id (string): UUID du site web.
  • accountGroupId (string): Groupe de compte résolu depuis le token.
  • domain (string): Domaine normalisé du site web.
  • url (string): URL du site web.
  • name (string | null): Nom affiché.
  • description (string | null): Contexte utilisé pour le score de pertinence.
  • createdAt, updatedAt (ISO string | null): Horodatages de création et de mise à jour au format ISO 8601, ou null.
  • keywords (Keyword[]): Objets Keyword de ce site web.

Objet Keyword

  • 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.

Notes

Gardez une description précise; elle influence le score de pertinence IA.

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.
Exemple de requête (curl)
curl --request PATCH \
  --url https://ai.redreplier.com/ai-app/api/v1/websites/9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10 \
  --header 'Authorization: Bearer redreplier_test_1234567890' \
  --header 'Content-Type: application/json' \
  --data '{"name": "Acme CRM","description": "CRM for small agencies that need pipeline tracking and follow-up reminders."}'
200
{
  "id": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
  "accountGroupId": "acct_7dK9pQ2",
  "domain": "acmecrm.io",
  "url": "https://acmecrm.io",
  "name": "Acme CRM",
  "description": "CRM for small agencies that need pipeline tracking and client follow-up reminders.",
  "createdAt": "2026-05-22T10:15:30.000Z",
  "updatedAt": "2026-05-29T14:02:11.000Z",
  "keywords": [
    {
      "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"
    }
  ]
}