Get Knowledge Base Article Content API

Retrieve the content of a Knowledge Base article in a specific language. Content can be returned as either Markdown or HTML.

Endpoint

GET /v1/knowledge-base/articles/{correlationId}/content/{lang}

Path Parameters

Query Parameters

Format Behavior

Knowledge Base articles are originally imported into Product Fruits as Markdown.

However, after a user edits and saves an article in the Product Fruits editor, HTML becomes the canonical source of the article content. This can affect how Markdown responses are generated.

format=html

Returns the current canonical HTML content. Use this format when you need the most accurate representation of the article as it currently exists in Product Fruits.

format=markdown

Returns Markdown content.

Behavior depends on whether the article has been edited after import:

• If the article has not been edited since import, the original Markdown is returned unchanged.
• If the article has been edited, the current HTML content is converted back to Markdown.

Because some HTML elements do not have a direct Markdown equivalent, converted Markdown responses may include a conversionResults array. This array describes any elements that were dropped, simplified, or changed during conversion.

Examples of possible conversion limitations include:

• iframe embeds
• video embeds
• custom HTML blocks
• table styling
• code-block language hints

conversionResults is empty when:

• format=html is used, or
• the original Markdown is returned unchanged.

Example Request

GET /v1/knowledge-base/articles/rich-md-fixture/content/en?format=markdown

Example Response

{
  "articleId": 5876,
  "articleCorrelationId": "rich-md-fixture",
  "contentId": 12044,
  "contentCorrelationId": "...",
  "lang": "en",
  "title": "...",
  "slug": "...",
  "keywords": "...",
  "lead": "...",
  "published": true,
  "lastModified": "2026-05-25T10:14:00Z",
  "format": "markdown",
  "content": "# ...",
  "conversionResults": [
    {
      "type": "dropped",
      "element": "iframe",
      "count": 1,
      "message": "YouTube video embed dropped"
    }
  ]
}

Response Fields

Conversion Result Object

When Markdown is requested for an article that has been edited in the Product Fruits editor, the API may convert the current HTML back to Markdown. Any lossy or simplified conversions are listed in conversionResults.

Error Responses

Notes

For the most accurate content representation, use format=html.

Use format=markdown when you need Markdown output, but check conversionResults to detect whether any HTML elements were lost or simplified during conversion.