API referencePOST
Activate pending keywords
Activate pending keywords up to the free slots on the current plan. Never charges or upgrades the plan.
POST
https://ai.redreplier.com/ai-app/api/v1/keywords/activate-pendingActivate pending keywords up to the free slots on the current plan. Never charges or upgrades the plan.
Bearer Token (RedReplier API token)
Parameters
This endpoint does not take path or query parameters.
Request body
This endpoint does not require a JSON body.
Response
Returns all monitored websites with updated keyword statuses.
websites(Website[]): All monitored websites after activation, including updated keyword statuses.
Website object
id(string): Website UUID.accountGroupId(string): Account group resolved from the token.domain(string): Normalized website domain.url(string): Website URL.name(string | null): Display name.description(string | null): Context used for relevance scoring.createdAt, updatedAt(ISO string | null): Creation and update timestamps in ISO 8601 format, ornull.keywords(Keyword[]): Keyword objects for this website.
Keyword object
id(string): Keyword UUID.websiteId(string): Parent website UUID.value(string): Keyword text, up to 255 characters.status(string):PENDING,ACTIVE,DISABLED, orSUSPENDED.createdAt, updatedAt(ISO string | null): Creation and update timestamps in ISO 8601 format, ornull.
Notes
Never charges. Keywords beyond the current plan stay PENDING until the plan is upgraded in the RedReplier app; the API cannot change the plan. GET /websites runs the same activation on every call.
Errors
400 Bad Request: Invalid input, URL, UUID, enum, query parameter, or body.401 Unauthorized: Missing or invalid Bearer token, orcode: "token_issuer_lost_access"when the person who created the API key was deactivated or left the workspace.403 Forbidden:code: "subscription_required"when the workspace plan does not include API access,code: "workspace_access_denied"whenX-Workspace-Idnames a workspace this credential cannot reach, orcode: "permission_denied"when your role in the workspace does not holdredreplier.write(Admin and Editor hold it).404 Not Found: The resource does not exist for the token account.429 Too Many Requests: Rate limit exceeded. Wait the seconds inRetry-After.500 Internal Server Error: Unexpected server error.
Example request (curl)
curl --request POST \
--url https://ai.redreplier.com/ai-app/api/v1/keywords/activate-pending \
--header 'Authorization: Bearer redreplier_test_1234567890'201
{
"websites": [
{
"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"
}
]
}
]
}