/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/blocked-termsAuthAdd a hidden word to the community lexicon. A comment whose body contains the term is routed to `action`: `hide` → lands hidden; `pending_approval` → lands in the approve lane. Re-adding a term updates its action. Case-insensitive.
Path parameters
workspace_id*string · uuidId of the workspace.
community_id*string · uuidId of the community.
Headers
Idempotency-KeystringOpaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.
Request body
term*stringThe word/phrase to block (case-insensitive substring). Max 128 chars.
Example: "spoiler"
actionenum (2)What a match does. Default `hide`.
Example: "hide"
Response · 201 Blocked term added.
id*string · uuidBlocked term UUID.
Example: "ffffffff-2222-0000-0000-000000000001"
community_id*string · uuidOwning community UUID.
Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"
term*stringThe blocked term (lowercased).
Example: "spoiler"
action*objectWhat a match does.
Example: "hide"
created_at*string · date-timeISO timestamp the term was added.
Example: "2026-05-01T12:00:00.000Z"
Example
Request
POST https://social.productcraft.co/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/blocked-terms
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"term": "spoiler",
"action": "hide"
}Response
{
"id": "ffffffff-2222-0000-0000-000000000001",
"community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
"term": "spoiler",
"action": "hide",
"created_at": "2026-05-01T12:00:00.000Z"
}