Skip to content
Home/
REST API Reference
/
/
Create Content Snippet Re...

Create Content Snippet Request

The request payload for creating a content snippet. You must provide either json_blocks or body_markdown for the snippet content — they are mutually exclusive.

titlestring, <= 255 charactersrequired

The title of the content snippet.

Example:"How to reset your password"
json_blocksArray of objects

The content blocks that make up the body of the snippet. Mutually exclusive with body_markdown.

Example:
[
  {
    "type": "paragraph",
    "text": "Navigate to Settings > Security > Reset password."
  }
]
body_markdownstring

The content of the snippet in markdown. An alternative to json_blocks — you can provide content as markdown instead of structured blocks. Mutually exclusive with json_blocks.

Example:"# Hello\n\nSome content.\n"
localestring

The locale of the content snippet. Defaults to en.

Default:"en"
Example:"en"
audience_idsArray of integers or null

The list of audience IDs to target this content snippet to for Fin AI Agent. Pass an empty array or omit the field for no audience targeting. Unknown audience IDs return a 404 error with no partial commit.

Example:
[
  1,
  2
]
ai_chatbot_availabilityboolean

Whether the content snippet should be available for AI Chatbot (Fin). Defaults to false.

Default:false
Example:true
ai_copilot_availabilityboolean

Whether the content snippet should be available for AI Copilot. Defaults to false.

Default:false
Example:true
ai_sales_agent_availabilityboolean

Whether the content snippet should be available for AI Sales Agent. Defaults to false.

Default:false
Example:true
{
  "title": "How to reset your password",
  "json_blocks": [
    { … }
  ],
  "body_markdown": "# Hello\n\nSome content.\n",
  "locale": "en",
  "audience_ids": [
    1,
    2
  ],
  "ai_chatbot_availability": true,
  "ai_copilot_availability": true,
  "ai_sales_agent_availability": true
}