Upsert Content Translation

Creates or updates a translation for a content item in a specific locale.

This operation doesn’t modify translations in other locales or other content fields.

Note: You must first add the locale in the Publisher Dashboard before adding its translation.

PUT /v1/portal-content/{contentId}/translations/{isoCode}

Upsert Content Translation

curl -X PUT \
  'https://api.appcharge.com/v1/portal-content/507f1f77bcf86cd799439011/translations/fr-FR' \
  -H 'Content-Type: application/json' \
  -H 'x-publisher-token: <x-publisher-token>' \
  -d '{
    "title": "Bienvenue dans notre jeu",
    "subTitle": "Tout ce que vous devez savoir",
    "bodyText": "Ceci est le contenu principal de l'\''article en français...",
    "headerImage": "https://cdn.example.com/images/header-fr.jpg",
    "thumbnailImage": "https://media.appcharge.com/media/25cb4861ec8924a6b69a0f59/book-shelf1920.jpg",
    "labels": ["tutoriel", "débutant"]
  }'

Upsert Content Translation

{
  "id": "507f1f77bcf86cd799439011",
  "title": "Welcome to Our Game",
  "subTitle": "Everything you need to know",
  "bodyText": "This is the main content body with detailed information...",
  "headerImage": "https://cdn.example.com/images/header.jpg",
  "thumbnailImage": "https://media.appcharge.com/media/25cb4861ec8924a6b69a0f59/book-shelf1920.jpg",
  "labels": ["tutorial", "beginner"],
  "state": "visible",
  "contentType": "article",
  "slug": "welcome-to-our-game",
  "visibility": "public",
  "tag": "spring2025",
  "createdAt": "2025-10-15T10:30:00.000Z",
  "updatedAt": "2025-10-20T14:45:00.000Z",
  "translations": [
    {
      "isoCode": "fr-FR",
      "title": "Bienvenue dans notre jeu",
      "subTitle": "Tout ce que vous devez savoir",
      "bodyText": "Ceci est le contenu principal de l'article en français...",
      "headerImage": "https://cdn.example.com/images/header-fr.jpg",
      "thumbnailImage": "https://media.appcharge.com/media/25cb4861ec8924a6b69a0f59/book-shelf1920.jpg",
      "labels": ["tutoriel", "débutant"]
    }
  ],
  "pages": [
    {
      "id": "6850249eb5bd5c59b9bab7e2",
      "pageName": "FAQs"
    }
  ]
}

Upsert Content Translation

curl -X PUT \
  'https://api.appcharge.com/v1/portal-content/507f1f77bcf86cd799439011/translations/fr-FR' \
  -H 'Content-Type: application/json' \
  -H 'x-publisher-token: <x-publisher-token>' \
  -d '{
    "title": "Bienvenue dans notre jeu",
    "subTitle": "Tout ce que vous devez savoir",
    "bodyText": "Ceci est le contenu principal de l'\''article en français...",
    "headerImage": "https://cdn.example.com/images/header-fr.jpg",
    "thumbnailImage": "https://media.appcharge.com/media/25cb4861ec8924a6b69a0f59/book-shelf1920.jpg",
    "labels": ["tutoriel", "débutant"]
  }'

Upsert Content Translation

{
  "id": "507f1f77bcf86cd799439011",
  "title": "Welcome to Our Game",
  "subTitle": "Everything you need to know",
  "bodyText": "This is the main content body with detailed information...",
  "headerImage": "https://cdn.example.com/images/header.jpg",
  "thumbnailImage": "https://media.appcharge.com/media/25cb4861ec8924a6b69a0f59/book-shelf1920.jpg",
  "labels": ["tutorial", "beginner"],
  "state": "visible",
  "contentType": "article",
  "slug": "welcome-to-our-game",
  "visibility": "public",
  "tag": "spring2025",
  "createdAt": "2025-10-15T10:30:00.000Z",
  "updatedAt": "2025-10-20T14:45:00.000Z",
  "translations": [
    {
      "isoCode": "fr-FR",
      "title": "Bienvenue dans notre jeu",
      "subTitle": "Tout ce que vous devez savoir",
      "bodyText": "Ceci est le contenu principal de l'article en français...",
      "headerImage": "https://cdn.example.com/images/header-fr.jpg",
      "thumbnailImage": "https://media.appcharge.com/media/25cb4861ec8924a6b69a0f59/book-shelf1920.jpg",
      "labels": ["tutoriel", "débutant"]
    }
  ],
  "pages": [
    {
      "id": "6850249eb5bd5c59b9bab7e2",
      "pageName": "FAQs"
    }
  ]
}

Headers

x-publisher-token · string · required

Publisher token.

Path Parameters

contentId · string · required

Content ID.

isoCode · string · required

The locale code. Both ISO-639-1 language code and ISO-3166-1 alpha-2 country code formats are supported.

Body

application/json

title · string · required

Translated title.

Example:

"Bienvenue dans notre jeu"

subTitle · string · required

Translated subtitle.

Example:

"Tout ce que vous devez savoir"

bodyText · string · required

Translated body text.

Example:

"Ceci est le contenu principal de l'article en français..."

headerImage · string · required

Translated header image URL. Can be an external link or the URL of an image from the Assets Library.

Example:

"https://cdn.example.com/images/header-fr.jpg"

thumbnailImage · string · required

Translated thumbnail image URL. Can be an external link or the URL of an image from the Assets Library.

Example:

"https://media.appcharge.com/media/25cb4861ec8924a6b69a0f59/book-shelf1920.jpg"

labels · string[] · required

Translated labels.

Example:

["tutoriel", "débutant"]

Response

200

application/json

Translation upserted successfully. Returns the full updated content item.

id · string

Content ID.

Example:

"507f1f77bcf86cd799439011"

title · string

Content title.

Example:

"Welcome to Our Game"

subTitle · string

Content description.

Example:

"Everything you need to know"

bodyText · string

Content body text.

Example:

"This is the main content body with detailed information..."

headerImage · string

Content header image URL.

Example:

"https://cdn.example.com/images/header.jpg"

thumbnailImage · string

Content thumbnail image URL.

Example:

"https://media.appcharge.com/media/25cb4861ec8924a6b69a0f59/book-shelf1920.jpg"

labels · string[]

List of labels associated with the content.

Example:

["tutorial", "beginner"]

state · enum<string> · default: hidden

Current state of the content.

Available options: visible, hidden, scheduled

Example:

"hidden"

contentType · enum<string>

Content type.

Available options: article, news

Example:

"article"

publishDate · string<date-time>

Content publish date. Use for scheduling content.

Example:

"2025-10-20T00:00:00.000Z"

slug · string

Content slug. If not provided, this value is auto-generated.

Example:

"welcome-to-our-game"

visibility · enum<string> · default: public

Content visibility level.

Available options: public, private

Example:

"public"

tag · string

Internal tag for organizing your content. Not visible to players.

Example:

"spring2025"

createdAt · string<date-time>

Created date.

Example:

"2025-10-15T10:30:00.000Z"

updatedAt · string<date-time>

Updated date.

Example:

"2025-10-19T14:20:00.000Z"

translations · object[]

List of translations for the content item. Each object represents a locale and its translations.

Show child attributes

pages · object[]

List of pages where this content appears.

Show child attributes

Example:

[
  {
    "id": "68b0249eb5bd5c59b9bab7e2",
    "pageName": "FAQs"
  },
  {
    "id": "692eb70d0293e07ab4895518",
    "pageName": "Events"
  }
]