Get an article translation

Returns the localized version of an article for one locale.

GET /v1/articles/{id}/translations/{locale}

Bearer token scope content:read

curl 'https://api.ferndesk.com/v1/articles/art_01JXY9AZK4KV/translations/en?format=markdown' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "articleId": "art_01JXY9AZK4KV",
  "language": "fr",
  "title": "Débuter avec les clés API",
  "contentHtml": "<p>Découvrez le fonctionnement des clés API.</p>",
  "contentMarkdown": "# Découvrez le fonctionnement des clés API",
  "contentJson": {
    "type": "doc",
    "content": [
      {
        "type": "paragraph",
        "content": [
          {
            "type": "text",
            "text": "Welcome to Ferndesk."
          }
        ]
      }
    ]
  },
  "url": "https://docs.example.com/fr/getting-started-api-keys-A1B2C3",
  "status": "published",
  "updatedAt": "2026-01-15T18:25:43.511Z"
}

Article translation

Path parameters

· 2

id string required

Identifier of the requested resource.

locale string · min length: 2· max length: 16 required

Locale code of the translation.

Query parameters

· 1

format string · default: html· enum

Which body field to populate: contentHtml, contentMarkdown, or the lossless contentJson.

values

html
markdown
json

Path parameters

Query parameters

Responses