Ayudala icon

Ayudala

Interact with the Ayudala helpdesk & service management platform

Actions82

KB Article → Create

AI-generated

Summary

Create a knowledge base article.

Inputs

  • title (required) — The title of the article
  • content (required) — The Markdown content of the article
  • categoryId (required) — The category ID for the article (use Get Categories to list available IDs)
  • summary — Short excerpt of the article
  • tags — Comma-separated tags
  • visibility — Article visibility level (public or internal)
  • is_published — Whether to publish the article immediately after creation

Output shape

a single KB article record

Returns the created article including its generated ID and timestamps; fails with an error if the category ID does not exist.

Examples

Example 1: Add a new KB article with title 'Welcome', Markdown content, category ID 5, set visibility to public and publish immediately.

title='Welcome', content='Welcome to our support site.', categoryId=5, additionalFields={summary='Welcome message', tags='intro', visibility='public', is_published=true}

Example 2: Create a KB article that is not published immediately, using internal visibility and adding summary and tags.

title='Policy Update', content='Updated policy details.', categoryId=2, additionalFields={summary='New policy', tags='policy,internal', visibility='internal', is_published=false}

Links

Discussion