API referenceDEL

Delete keyword

Permanently delete a pending keyword.

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

Permanently delete a pending keyword.

Bearer Token (RedReplier API token)

Parameters

  • keywordId (path, UUID, required): Pending keyword to delete.

Request body

This endpoint does not require a JSON body.

Response

Returns a deletion confirmation.

  • deleted (boolean): Always true when the delete operation succeeds.

Notes

Only PENDING keywords can be deleted. Disable active keywords instead.

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 DELETE \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "deleted": true
}