> ## Documentation Index
> Fetch the complete documentation index at: https://docs.puntego.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Translate Knowledge articles

> Create locale-specific Knowledge versions with explicit review, publication, fallback, and revision history.

Knowledge translations let the guide answer with an approved locale-specific
version of a Knowledge article. Puntego does not machine-translate or invent the
content: an owner or admin supplies each translation and deliberately moves it
through review and publication.

## Create and publish a translation

1. Open **Knowledge → Articles** and expand an article workspace.
2. Open **Translations**, select **Add translation**, and enter a BCP-47 locale
   such as `es`, `es-MX`, or `fr-CA`.
3. Enter the translated title, answer, and optional search aliases. Puntego
   derives the bounded search summary from that answer.
4. Save the draft, then submit it for review.
5. An owner or admin approves it or requests changes with a review note.
6. Publish the approved revision.

Approval and publication are separate, audited actions. The same person may
author and review a translation, but Puntego records that identity rather than
implying independent review. Every edit and workflow transition appends an
immutable revision.

<Warning>
  Publishing never happens automatically. Verify product terminology, legal
  meaning, links, and locale-specific requirements before approval.
</Warning>

## Keep a live version while editing

Once published, the approved revision remains live while a newer draft is
edited or reviewed. If the source article changes after a translation was
created, the workspace marks both the current draft and the live publication as
stale where applicable. Stale content is not silently rewritten or replaced,
and a stale draft cannot enter review or be published until it is updated
against a newer source revision.

Archiving removes the translation from visitor retrieval. Restoring an archive
creates a draft and deliberately clears its old live pointer, so it must be
reviewed and published again before visitors receive it. Deleting the source
article or workspace also deletes its translation projection and immutable
translation revisions.

## Locale selection and fallback

For guide requests, Puntego reads the visitor's preferred locale from the
request `Accept-Language` header and canonicalizes it as a BCP-47 tag. Retrieval
uses this order:

1. Exact locale, such as `es-MX`.
2. Base language, such as `es`.
3. The published source article.

Search results identify the requested locale, actual content locale, and
fallback reason. Puntego does not claim that a source-article fallback is in the
visitor's language because a source article's language may be unknown.

## API workflow

Translation routes are nested beneath the source article:

```text theme={null}
GET    /api/tenants/:tenantId/knowledge/articles/:articleId/translations
POST   /api/tenants/:tenantId/knowledge/articles/:articleId/translations
GET    /api/tenants/:tenantId/knowledge/articles/:articleId/translations/:translationId
PUT    /api/tenants/:tenantId/knowledge/articles/:articleId/translations/:translationId
POST   /api/tenants/:tenantId/knowledge/articles/:articleId/translations/:translationId/submit-review
POST   /api/tenants/:tenantId/knowledge/articles/:articleId/translations/:translationId/review
POST   /api/tenants/:tenantId/knowledge/articles/:articleId/translations/:translationId/publish
POST   /api/tenants/:tenantId/knowledge/articles/:articleId/translations/:translationId/archive
POST   /api/tenants/:tenantId/knowledge/articles/:articleId/translations/:translationId/restore
```

Mutations require a workspace owner or admin, use optimistic `baseRevision`
checks, reject unknown fields, and are rate and payload limited. Publishing
without an approved review fails closed.

Translation content and review history are included in the workspace
operational export. They follow the source article's tenant isolation and
deletion lifecycle.

Each source article supports up to 32 locale variants. The detail API and
workspace show the newest 100 immutable revisions for a locale; the operational
export includes the retained revision rows without that display-page limit.

<Card title="Manage Knowledge sources" icon="database" href="/knowledge-connectors">
  Connect supported documentation sources and monitor their indexing health.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.