API referencePOST

Disable keyword

Pause monitoring for a keyword.

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

Pause monitoring for a keyword.

Bearer Token (RedReplier API token)

Parameters

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

Request body

This endpoint does not require a JSON body.

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

Disabling stops monitoring immediately and does not consume the edit allowance.

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 POST \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d/disable \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "id": "73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d",
  "websiteId": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
  "value": "agency CRM",
  "status": "DISABLED",
  "createdAt": "2026-05-22T10:16:00.000Z",
  "updatedAt": "2026-05-29T14:02:11.000Z"
}