Referencia de APIPATCH

Editar palabra clave

Cambia el texto de una palabra clave existente.

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

Cambia el texto de una palabra clave existente.

Token Bearer (token de API de RedReplier)

Autenticación

Envía un token de API de RedReplier como Bearer token en cada solicitud. Los tokens empiezan por redreplier_; RedReplier resuelve la cuenta desde el token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parámetros

  • keywordId (ruta, UUID, obligatorio): Palabra clave que se editará.

Cuerpo de la solicitud

  • value (string, obligatorio, máximo 255): Nuevo texto de la palabra clave.

Respuesta

Devuelve un objeto Keyword público.

  • id (string): UUID de la palabra clave.
  • websiteId (string): UUID del sitio web principal.
  • value (string): Texto de la palabra clave, hasta 255 caracteres.
  • status (string): PENDING, ACTIVE, DISABLED o SUSPENDED.
  • createdAt, updatedAt (ISO string | null): Marcas de creación y actualización en formato ISO 8601, o null.

Solicitud de ejemplo

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"}'

Notas

Editar palabras clave activas puede contar contra el cupo mensual de edición. Editar una palabra clave SUSPENDED es la forma normal de corregir términos ruidosos.

Errores

  • 400 Bad Request: Entrada, URL, UUID, enum, parámetro de consulta o cuerpo no válido.
  • 401 Unauthorized: Bearer token ausente o no válido.
  • 404 Not Found: El recurso no existe para la cuenta del token.
  • 500 Internal Server Error: Error inesperado del servidor.
Solicitud de ejemplo (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"
}