Aveiro API
Authentication
Sites
List Sites
List Templates
Create Site
Update Site Layout
Chrome Strings
Update Collection
Pages
Create a Page
Delete a Page
List Pages
Reorder Pages
Update a Page
Site Media
Publish Site
Link Translation
Import Media from URL
Audience
Newsletter API Overview
Newsletter Campaigns
Social
Social API Overview
Social Accounts
Social Media
Social Posts
Social Performance
Website Mockup Video
TrademarkTrademark
Ctrl k
Search…
Sign up
Aveiro API
Authentication
Sites
List Sites
List Templates
Create Site
Update Site Layout
Chrome Strings
Update Collection
Pages
Create a Page
Delete a Page
List Pages
Reorder Pages
Update a Page
Site Media
Publish Site
Link Translation
Import Media from URL
Audience
Newsletter API Overview
Newsletter Campaigns
Social
Social API Overview
Social Accounts
Social Media
Social Posts
Social Performance
Website Mockup Video
Sponsored
Aveiro
aveiro.app
Sponsored
Aveiro
aveiro.app
TrademarkTrademark
AveiroBlogContact
© Aveiro. All rights reserved.
Built with Aveiro

Link Translation

POST /api/v1/sites/{siteId}/pages/link-translation — link an existing locale page as a translation variant.
Updated 55m ago
Publish Site
Import Media from URL
In short
POST /api/v1/sites/{siteId}/pages/link-translation connects an existing page under a locale prefix to a default-locale source page so sidebars, hreflang, locale-scoped publish, and translation filters recognize it. Requires content:write.

Request

POST /api/v1/sites/{siteId}/pages/link-translation
Authorization: Bearer av_live_…
Content-Type: application/json

{
  "source": { "path": "/guides/overview.mdx" },
  "variant": { "path": "/de/guides/custom-overview.mdx" },
  "locale": "de"
}
Required scope: content:write Both source and variant accept { content_id } or { path }.

When to use it

Use this when an agent or script created MDX directly under /de/… (or another locale folder) before the page was registered as a translation variant. Until linked, untranslated_for still lists the source page and locale-scoped publish skips the orphan file. Prefer creating variants with translation_of + locale on Create a page when you control the write path.

Response

200 OK 
{
  "linked": true,
  "already_linked": false,
  "source_id": "…",
  "variant_id": "…",
  "path": "/de/guides/custom-overview.mdx",
  "locale": "de",
  "translation_group_id": "…",
  "note": "This page is now a "de" variant. It publishes only with locale_scope:"all" or locale_scope:["de"] …"
}

Related

  • Create a page — translation_of + locale
  • List pages — untranslated_for and stale_translations
  • Publish site — locale_scope
  • Translations overview — editor workflow