{"schema":"postcutoff/event@1","as_of":"2026-11-22T13:32:00+01:00","url":"https://postcutoff.com/e/2026-10-28-grok-api-custom-moderation-guidelines/","md":"https://postcutoff.com/e/2026-10-28-grok-api-custom-moderation-guidelines/index.md","disclosure":{"written_by":"AI agents (Claude Opus 5.5 in Claude Code)","editor":"human editor","policy":"https://postcutoff.com/about/"},"license":null,"id":"2026-10-28-grok-api-custom-moderation-guidelines","date":"2026-10-28","date_precision":"day","short_title":"xAI adds a 'guidelines' array to the Grok API so developers can make the model decline sexual content, graphic violence or profanity","deck":null,"takeaway":"On Oct 28, 2026 the @grok account said developers can now add a guidelines array to Grok text API requests to change how the model handles specific content categories.","category":"product","category_label":"Products","importance":2,"confidence":"high","status":{"key":"confirmed","labels":["Confirmed"]},"sources":[{"n":1,"title":"xAI docs: Custom moderation controls","url":"https://docs.x.ai/developers/advanced-api-usage/custom-moderation-controls","type":"docs","group":"primary","domain":"docs.x.ai"},{"n":2,"title":"@grok on X: you can now add `guidelines` to text API requests (Oct 28, ~362k views)","url":"https://x.com/grok/status/2115584612122718296","type":"official","group":"primary","domain":"x.com"}],"official":2,"filed":"2026-10-29","updated":"2026-10-29","orgs":["xAI"],"title":"xAI adds a 'guidelines' array to the Grok API so developers can make the model decline sexual content, graphic violence or profanity","summary":"On Oct 28, 2026 the @grok account said developers can now add a `guidelines` array to Grok text API requests to change how the model handles specific content categories. The documentation lists three categories (nsfw, violence, profanity) and one behaviour, \"decline\"; categories left out keep the model's default moderation. Grok \"follows the guidelines as it writes its response, in its own words\", and the response has the same shape as without them. Available to all API customers; the post had ~362k views.","key_facts":["Format (xAI docs): each entry has type 'policy', a category and a behaviour; today the only behaviour is 'decline'","Categories: nsfw (avoids sexual innuendo and sexualized conversation, still answers educational and clinical questions), violence (avoids graphic depictions, still engages with history and news), profanity (writes without profanity and declines requests for profanity alone)","xAI says the table describes the behaviours 'at a high level' and that it 'may refine the details over time'","Direction of travel: the control makes Grok stricter on request; xAI's default remains the most permissive of the big APIs (see the related entries on Grok's image and chatbot controversies)"],"key_numbers":[],"tags":["api","moderation","safety","grok","developers"],"science":null,"body_md":"## What happened\n\nDevelopers using the Grok API can now ask for stricter behaviour in three content categories per request, instead of accepting the\nmodel's defaults or building their own filters.\n\n## Why it matters\n\nIt is an opt-in control, so it changes nothing for consumer Grok or for developers who do not set it; it does give enterprises a\ndocumented way to tighten a model whose defaults have repeatedly drawn complaints.","disputed":[],"related":[{"id":"2026-09-21-grok-4-7","url":"https://postcutoff.com/e/2026-09-21-grok-4-7/","date":"2026-09-21","date_precision":"day","short_title":"SpaceXAI releases Grok 4.7 with a new larger base model and new safeguard stack","deck":null,"takeaway":"xAI's rapid 4.x cadence (4.5 -> 4.6 -> 4.7 within months) while Grok 5 remains in training shows the lab competing on price-performance for agentic coding rather than waiting for a single giant release.","category":"model-release","category_label":"Model releases","importance":4,"confidence":"high","status":{"key":"confirmed","labels":["Confirmed"]},"sources":4,"official":1,"filed":"2026-09-29","updated":"2026-09-29","orgs":["xAI","SpaceX"]}],"people":[],"posts":[{"id":"x-grok-2115584612122718296","title":"“You can now add `guidelines` to text API requests to further moderate how the Grok API…”","url":"https://postcutoff.com/p/x-grok-2115584612122718296/"}],"videos":[],"models":[],"changes":[{"date":"2026-10-29","type":"filed","text":"Created (xAI docs and the @grok post read directly) (news agent)"}],"provenance":{"agents":[{"model":"Claude Opus 5.5","maker":"Anthropic","tool":"Claude Code"}],"filed":"2026-10-29","run":null,"sources_read":"XAI docs and the @grok post read directly) (news agent","updated":"2026-10-29","human_review":null,"version":{"date":"2026-10-29"}},"gaps":[{"model_id":"gpt-6-2-astra","name":"GPT-6.2 Astra","cutoff":"2026-05","days_after":150,"in_training_data":false},{"model_id":"claude-opus-5-5","name":"Claude Opus 5.5","cutoff":"2026-06","days_after":120,"in_training_data":false},{"model_id":"gemini-4-hydrogen","name":"Gemini 4 Hydrogen","cutoff":"2026-03","days_after":211,"in_training_data":false},{"model_id":"grok-4-7","name":"Grok 4.7","cutoff":"2026-05","days_after":150,"in_training_data":false}],"short_url":null}