API referencePATCH

Edit keyword

Change the text of an existing keyword.

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

Change the text of an existing keyword.

Bearer Token (RedReplier API token)

Parameters

  • keywordId (path, UUID, required): Keyword to edit.

Request body

  • value (string, required, max 255): New keyword text.

Response

Returns one public Keyword object.

  • id (string): Keyword UUID.
  • websiteId (string): Parent website UUID.
  • value (string): Keyword text, up to 255 characters.
  • status (string): PENDING, ACTIVE, DISABLED, or SUSPENDED.
  • createdAt, updatedAt (ISO string | null): Creation and update timestamps in ISO 8601 format, or null.

Notes

Editing active keywords can count against the monthly keyword edit allowance. Editing a SUSPENDED keyword is the normal way to fix noisy terms.

Errors

  • 400 Bad Request: Invalid input, URL, UUID, enum, query parameter, or body.
  • 401 Unauthorized: Missing or invalid Bearer token.
  • 404 Not Found: The resource does not exist for the token account.
  • 500 Internal Server Error: Unexpected server error.
Example request (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"
}