API-ReferenzPATCH

Keyword bearbeiten

Ändert den Text eines vorhandenen Keywords.

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

Ändert den Text eines vorhandenen Keywords.

Bearer-Token (RedReplier-API-Token)

Authentifizierung

Sende bei jeder Anfrage ein RedReplier-API-Token als Bearer-Token. Tokens beginnen mit redreplier_; RedReplier ermittelt das Konto aus dem Token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameter

  • keywordId (Pfad, UUID, erforderlich): Keyword, das bearbeitet wird.

Request-Body

  • value (String, erforderlich, max. 255): Neuer Keyword-Text.

Antwort

Gibt ein öffentliches Keyword-Objekt zurück.

  • id (string): Keyword-UUID.
  • websiteId (string): UUID der übergeordneten Website.
  • value (string): Keyword-Text mit bis zu 255 Zeichen.
  • status (string): PENDING, ACTIVE, DISABLED oder SUSPENDED.
  • createdAt, updatedAt (ISO string | null): Erstellungs- und Aktualisierungszeitpunkte im ISO-8601-Format oder null.

Beispielanfrage

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

Hinweise

Das Bearbeiten aktiver Keywords kann das monatliche Edit-Kontingent belasten. Ein SUSPENDED Keyword zu bearbeiten ist der normale Weg, ungenaue Begriffe zu korrigieren.

Fehler

  • 400 Bad Request: Ungültige Eingabe, URL, UUID, Enum, Query-Parameter oder Body.
  • 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token.
  • 404 Not Found: Die Ressource existiert nicht für das Token-Konto.
  • 500 Internal Server Error: Unerwarteter Serverfehler.
Beispielanfrage (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"
}