Skip to main content
The Knowledge API works on the articles in your knowledge base: ones you wrote in Decimal and ones imported from your helpdesk or other integrations.

​
Articles

Each article has its body in Markdown in content, plus:

​
Filters

List, search, and bulk delete all take the same filters, alone or combined:
  • source: articles from one source, such as manual
  • status: published or in_review
  • tag: articles with one tag
List returns newest first and paginates. Search matches on meaning as well as keywords, and returns the best match first. query can be up to 500 characters, and limit returns up to 50 results.
New and edited articles show up in search within a few minutes.

​
Delete articles

Delete one article by ID, or every article matching a set of filters. Bulk delete needs at least one filter, and removes up to 1,000 articles per request. When the response has has_more: true, send the same request again until it’s false. The agent stops using a deleted article within a few minutes. An article imported from a helpdesk comes back on its next sync if it still exists there, so delete it at the source first.