API-referentiePOST

Trefwoorden toevoegen

Voeg een of meer trefwoorden toe aan een gevolgde website, zodat RedReplier bijpassende threads ervoor gaat beoordelen.

POSThttps://ai.redreplier.com/ai-app/api/v1/websites/{websiteId}/keywords

Voeg een of meer trefwoorden toe aan een gevolgde website, zodat RedReplier bijpassende threads ervoor gaat beoordelen.

Bearer-token (RedReplier API-token)

Authenticatie

Stuur bij elk verzoek een RedReplier-API-token mee als Bearer-token. Tokens beginnen met redreplier_; RedReplier leidt het account af uit het token. Stuur X-Workspace-Id mee om in een andere workspace dan de standaardworkspace te werken; zie Workspaces weergeven.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameters

  • websiteId (pad, UUID, verplicht): Website die de trefwoorden krijgt.

Request body

  • keywords (string[], verplicht, niet leeg): Trefwoorden om toe te voegen; elke waarde mag maximaal 255 tekens lang zijn.

Respons

Geeft één openbaar Website-object terug.

Website-object

  • id (string): UUID van de website.
  • accountGroupId (string): Accountgroep die uit het token is afgeleid.
  • domain (string): Genormaliseerd domein van de website.
  • url (string): URL van de website.
  • name (string | null): Weergavenaam.
  • description (string | null): Context die wordt gebruikt voor de relevantiescore.
  • createdAt, updatedAt (ISO string | null): Tijdstempels van aanmaak en wijziging in ISO 8601-formaat, of null.
  • keywords (Keyword[]): Keyword-objecten van deze website.

Keyword-object

  • id (string): UUID van het trefwoord.
  • websiteId (string): UUID van de bovenliggende website.
  • value (string): Tekst van het trefwoord, maximaal 255 tekens.
  • status (string): PENDING, ACTIVE, DISABLED of SUSPENDED.
  • createdAt, updatedAt (ISO string | null): Tijdstempels van aanmaak en wijziging in ISO 8601-formaat, of null.

Voorbeeldverzoek

curl -X POST https://ai.redreplier.com/ai-app/api/v1/websites/11111111-1111-4111-8111-111111111111/keywords \
  -H 'Authorization: Bearer redreplier_test_1234567890' \
  -H 'Content-Type: application/json' \
  -d '{"keywords":["agency CRM","client onboarding software"]}'

Opmerkingen

Trefwoorden toevoegen staat los van bewerken. Trefwoorden die binnen het abonnement passen, worden meteen ACTIVE. De rest blijft PENDING totdat het abonnement ruimte heeft.

Fouten

  • 400 Bad Request: Ongeldige invoer, URL, UUID, enum, queryparameter of body.
  • 401 Unauthorized: Bearer-token ontbreekt of is ongeldig, of code: "token_issuer_lost_access" wanneer de persoon die de API-sleutel heeft aangemaakt is gedeactiveerd of de workspace heeft verlaten.
  • 403 Forbidden: code: "subscription_required" wanneer het abonnement van de workspace geen API-toegang bevat, code: "workspace_access_denied" wanneer X-Workspace-Id een workspace noemt waar deze inloggegevens geen toegang toe hebben, of code: "permission_denied" wanneer je rol in de workspace geen redreplier.write heeft (Admin en Editor hebben die wel).
  • 404 Not Found: De resource bestaat niet voor het account van het token.
  • 429 Too Many Requests: Rate limit overschreden. Wacht het aantal seconden uit Retry-After.
  • 500 Internal Server Error: Onverwachte serverfout.
Voorbeeldverzoek (curl)
curl --request POST \
  --url https://ai.redreplier.com/ai-app/api/v1/websites/9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10/keywords \
  --header 'Authorization: Bearer redreplier_test_1234567890' \
  --header 'Content-Type: application/json' \
  --data '{"keywords":["agency CRM","client follow-up software","sales pipeline for agencies"]}'
201
{
  "id": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
  "accountGroupId": "acct_7dK9pQ2",
  "domain": "acmecrm.io",
  "url": "https://acmecrm.io",
  "name": "Acme CRM",
  "description": "CRM for small agencies that need pipeline tracking and client follow-up reminders.",
  "createdAt": "2026-05-22T10:15:30.000Z",
  "updatedAt": "2026-05-29T14:02:11.000Z",
  "keywords": [
    {
      "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"
    }
  ]
}