# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Hubspot Multi Language API
  version: 1.0.0
extends: openapi/hubspot-multi-language-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 29
- target: $.paths['/cms/blogs/2026-09/authors/multi-language/attach-to-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a blog author to a translation group
      effect: write
      questions:
      - How do I link a blog author profile to its version in another language?
      - Can I group an existing Spanish author bio with the English original?
      - What language code do I need when attaching a blog author to a multi-language group?
      instructions:
      - text: Attach blog author {id} as the {language} version of primary author {primaryId}.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
      - text: Link blog author {id} to author {primaryId}'s language group as {language}, with {primaryLanguage} as the group's primary language.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
          primaryLanguage: requestBody.primaryLanguage
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/authors/multi-language/create-language-variation'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a blog author into another language
      effect: write
      questions:
      - Can I clone a blog author profile to make a translated version?
      - What's the quickest way to get a French copy of an existing blog author?
      instructions:
      - text: Create a {language} variation of blog author {id}.
        slots:
          language: requestBody.language
          id: requestBody.id
      - text: Clone blog author {id} into a new language variation using author details {blogAuthor}.
        slots:
          id: requestBody.id
          blogAuthor: requestBody.blogAuthor
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/authors/multi-language/detach-from-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a blog author from a translation group
      effect: write
      questions:
      - How do I unlink a blog author from its other-language versions?
      - Can a translated author profile stand on its own again outside the language group?
      instructions:
      - text: Detach blog author {id} from its multi-language group.
        slots:
          id: requestBody.id
      - text: Unlink author profile {id} from its translations so it stands alone.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/authors/multi-language/set-new-lang-primary'].put
  update:
    x-apievangelist-phrasing:
      intent: Make a blog author the primary language version
      effect: write
      questions:
      - How do I change which blog author translation is the primary one?
      - Can I make the German author profile the main version of its language group?
      instructions:
      - text: Set blog author {id} as the primary language in its group.
        slots:
          id: requestBody.id
      - text: Make author profile {id} the main version its translations hang off.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/authors/multi-language/update-languages'].post
  update:
    x-apievangelist-phrasing:
      intent: Reassign languages across a blog author group
      effect: write
      questions:
      - I tagged my blog author translations with the wrong languages. How do I fix all of them at once?
      - Can I set the language of every author in a translation group in one call?
      instructions:
      - text: Set the languages for the blog author group led by {primaryId} to {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      - text: Relabel each blog author in primary author {primaryId}'s group using the map {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blog-settings/2026-09/settings/multi-language/attach-to-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a blog to a translation group
      effect: write
      questions:
      - How do I connect my French blog to the English blog as translations of each other?
      - Can two separate blogs be grouped so they're treated as language versions?
      instructions:
      - text: Attach blog {id} to primary blog {primaryId}'s language group as {language}.
        slots:
          id: requestBody.id
          primaryId: requestBody.primaryId
          language: requestBody.language
      - text: Group blog {id} in {language} with blog {primaryId}, whose primary language is {primaryLanguage}.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
          primaryLanguage: requestBody.primaryLanguage
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blog-settings/2026-09/settings/multi-language/create-language-variation'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a whole blog into another language
      effect: write
      questions:
      - Can I spin up a Spanish version of my entire blog from the existing one?
      - When I clone a blog into a new language, can I give it its own URL path?
      instructions:
      - text: Create a {language} version of blog {id}.
        slots:
          language: requestBody.language
          id: requestBody.id
      - text: Clone blog {id} into {language} and publish it at the path {slug}.
        slots:
          id: requestBody.id
          language: requestBody.language
          slug: requestBody.slug
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blog-settings/2026-09/settings/multi-language/detach-from-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a blog from a translation group
      effect: write
      questions:
      - How do I stop a blog from being treated as a translation of another blog?
      - Can I split one blog out of its multi-language group without deleting it?
      instructions:
      - text: Take the whole blog {id} out of its translation group.
        slots:
          id: requestBody.id
      - text: Unlink blog {id} from the other-language blogs it's grouped with.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blog-settings/2026-09/settings/multi-language/set-new-lang-primary'].put
  update:
    x-apievangelist-phrasing:
      intent: Make a blog the primary language version
      effect: write
      questions:
      - How do I make my Japanese blog the primary blog in its language group?
      - Which blog is the primary one in a translation group, and can I switch it?
      instructions:
      - text: Make the entire blog {id} the lead blog for its translated blogs.
        slots:
          id: requestBody.id
      - text: Switch the primary language of the blog group to match blog {id}.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blog-settings/2026-09/settings/multi-language/update-languages'].post
  update:
    x-apievangelist-phrasing:
      intent: Reassign languages across a group of blogs
      effect: write
      questions:
      - How do I correct the language assigned to each blog in a translation group?
      - Can I relabel all the blogs grouped under one primary blog in a single request?
      instructions:
      - text: Set the languages of the blogs grouped under primary blog {primaryId} to {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      - text: Update blog languages for group {primaryId} using the mapping {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/multi-language/attach-to-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a landing page to a translation group
      effect: write
      questions:
      - How do I link a translated landing page to the original campaign landing page?
      - Can I group two landing pages I built separately as language versions of each other?
      instructions:
      - text: Attach landing page {id} as the {language} version of landing page {primaryId}.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
      - text: Add landing page {id} in {language} to the group led by {primaryId}, primary language {primaryLanguage}.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
          primaryLanguage: requestBody.primaryLanguage
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/multi-language/create-language-variation'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a landing page into another language
      effect: write
      questions:
      - Can I duplicate a landing page as a starting point for its German translation?
      - Does a translated landing page copy the draft or the live version of the original?
      instructions:
      - text: Create a {language} variation of landing page {id}.
        slots:
          language: requestBody.language
          id: requestBody.id
      - text: Clone landing page {id} into a new language copy based on its current draft.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/multi-language/detach-from-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a landing page from a translation group
      effect: write
      questions:
      - How do I unlink a landing page from its translations?
      - Can a landing page leave its multi-language group and become standalone?
      instructions:
      - text: Detach landing page {id} from its multi-language group.
        slots:
          id: requestBody.id
      - text: Make landing page {id} standalone by removing it from its translation group.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/landing-pages/multi-language/update-languages'].post
  update:
    x-apievangelist-phrasing:
      intent: Reassign languages across a landing page group
      effect: write
      questions:
      - How do I fix the language labels on a set of translated landing pages?
      - Can I set the language of every landing page in a translation group at once?
      instructions:
      - text: Set the languages of the landing pages grouped under {primaryId} to {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      - text: Relabel landing page translations in group {primaryId} with {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/site-pages/multi-language/attach-to-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a website page to a translation group
      effect: write
      questions:
      - How do I link a translated website page to the original site page?
      - Can I connect an existing Italian site page to the English page as its translation?
      instructions:
      - text: Attach website page {id} as the {language} version of site page {primaryId}.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
      - text: Add site page {id} in {language} to page {primaryId}'s group, primary language {primaryLanguage}.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
          primaryLanguage: requestBody.primaryLanguage
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/site-pages/multi-language/create-language-variation'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a website page into another language
      effect: write
      questions:
      - Can I make a Portuguese copy of a website page to translate?
      - Is a translated website page copied from the draft of the source page?
      instructions:
      - text: Create a {language} variation of website page {id}.
        slots:
          language: requestBody.language
          id: requestBody.id
      - text: Clone site page {id} into a new translation from its draft.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/site-pages/multi-language/detach-from-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a website page from a translation group
      effect: write
      questions:
      - How do I unlink a website page from its other-language versions?
      - Can a site page be pulled out of its multi-language group?
      instructions:
      - text: Detach website page {id} from its multi-language group.
        slots:
          id: requestBody.id
      - text: Remove site page {id} from its translation group so it stands alone.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/site-pages/multi-language/set-new-lang-primary'].put
  update:
    x-apievangelist-phrasing:
      intent: Make a website page the primary language version
      effect: write
      questions:
      - How do I change which website page translation is the primary version?
      - Can I promote a translated site page to be the main page of its language group?
      instructions:
      - text: Set website page {id} as the primary language in its group.
        slots:
          id: requestBody.id
      - text: Promote site page {id} to primary version of its translations.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/pages/2026-09/site-pages/multi-language/update-languages'].post
  update:
    x-apievangelist-phrasing:
      intent: Reassign languages across a website page group
      effect: write
      questions:
      - How do I correct the languages on a group of translated website pages?
      - Can I relabel every site page in a translation group in one request?
      instructions:
      - text: Set the languages of the website pages grouped under {primaryId} to {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      - text: Relabel site page translations in group {primaryId} with {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/posts/multi-language/attach-to-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a blog post to a translation group
      effect: write
      questions:
      - How do I link a translated blog post to the original article?
      - Can I group a blog post I wrote separately in Dutch with its English original?
      instructions:
      - text: Attach blog post {id} as the {language} translation of post {primaryId}.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
      - text: Add post {id} in {language} to post {primaryId}'s language group, primary language {primaryLanguage}.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
          primaryLanguage: requestBody.primaryLanguage
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/posts/multi-language/create-language-variation'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a blog post into another language
      effect: write
      questions:
      - Can I copy a blog post to start its translation into another language?
      - What's the fastest way to create a Korean version of a published article?
      instructions:
      - text: Create a {language} variation of blog post {id}.
        slots:
          language: requestBody.language
          id: requestBody.id
      - text: Clone blog post {id} into a new language version.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/posts/multi-language/detach-from-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a blog post from a translation group
      effect: write
      questions:
      - How do I unlink a blog post from its translations?
      - Can a translated article be separated from the original post's language group?
      instructions:
      - text: Split article {id} away from its translated articles.
        slots:
          id: requestBody.id
      - text: Unlink post {id} from the other-language posts it's grouped with.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/posts/multi-language/set-new-lang-primary'].put
  update:
    x-apievangelist-phrasing:
      intent: Make a blog post the primary language version
      effect: write
      questions:
      - How do I make a translated blog post the primary version of the article?
      - Can I switch which language is primary for a group of translated posts?
      instructions:
      - text: Make article {id} the original that its translations point to.
        slots:
          id: requestBody.id
      - text: Make post {id}'s language the primary language of its translation group.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/posts/multi-language/update-languages'].post
  update:
    x-apievangelist-phrasing:
      intent: Reassign languages across a blog post group
      effect: write
      questions:
      - How do I fix the language tags on all translations of a blog post?
      - Can I set each translated article's language in one go?
      instructions:
      - text: Set the languages of the blog posts grouped under {primaryId} to {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      - text: Relabel the translations of post {primaryId} with {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/tags/multi-language/attach-to-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a blog tag to a translation group
      effect: write
      questions:
      - How do I link a translated blog tag to the original tag?
      - Can I treat my 'Noticias' tag as the Spanish version of the 'News' tag?
      instructions:
      - text: Attach blog tag {id} as the {language} version of tag {primaryId}.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
      - text: Add blog tag {id} in {language} to tag {primaryId}'s group, primary language {primaryLanguage}.
        slots:
          id: requestBody.id
          language: requestBody.language
          primaryId: requestBody.primaryId
          primaryLanguage: requestBody.primaryLanguage
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/tags/multi-language/create-language-variation'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a blog tag into another language
      effect: write
      questions:
      - Can I create a translated copy of a blog tag with a new name?
      - Do I have to name the new tag when I clone it into another language?
      instructions:
      - text: Create a {language} variation of blog tag {id} named {name}.
        slots:
          language: requestBody.language
          id: requestBody.id
          name: requestBody.name
      - text: Clone blog tag {id} as a translated tag called {name}.
        slots:
          id: requestBody.id
          name: requestBody.name
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/tags/multi-language/detach-from-lang-group'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a blog tag from a translation group
      effect: write
      questions:
      - How do I unlink a blog tag from its translations?
      - Can a translated tag leave its language group and become independent?
      instructions:
      - text: Pull tag {id} out of its tag translation set.
        slots:
          id: requestBody.id
      - text: Make blog tag {id} independent of its other-language tags.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/tags/multi-language/set-new-lang-primary'].put
  update:
    x-apievangelist-phrasing:
      intent: Make a blog tag the primary language version
      effect: write
      questions:
      - How do I change which blog tag translation is the primary one?
      - Can I promote a translated tag to be the main tag in its language group?
      instructions:
      - text: Make tag {id} the lead tag among its translated tags.
        slots:
          id: requestBody.id
      - text: Promote tag {id} to primary version of its translated tags.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/tags/multi-language/update-languages'].post
  update:
    x-apievangelist-phrasing:
      intent: Reassign languages across a blog tag group
      effect: write
      questions:
      - How do I correct the language on each translated blog tag?
      - Can I set the languages of all tags in a translation group at once?
      instructions:
      - text: Set the languages of the blog tags grouped under {primaryId} to {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      - text: Relabel the translations of tag {primaryId} with {languages}.
        slots:
          primaryId: requestBody.primaryId
          languages: requestBody.languages
      method: generated
      generated: '2026-09-24'