# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.DirectoryManagement Organization.organizational…
  version: 1.0.0
extends: openapi/azure-ad-organization-organizationalbranding-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 51
- target: $.paths['/organization/{organization-id}/branding'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the organization's default sign-in branding
      effect: read
      questions:
      - What sign-in page text and username hint does our default company branding use?
      - Why do I get a 404 when reading branding for an organization with none set up?
      instructions:
      - text: Show the default sign-in branding for organization {org}.
        slots:
          org: path.organization-id
      - text: Get company branding properties {select} for tenant {org}.
        slots:
          org: path.organization-id
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the default organizational branding
      effect: destructive
      questions:
      - Can I wipe out our default company branding entirely?
      - Do I have to remove all the branding images before deleting the default branding?
      instructions:
      - text: Delete the default company branding object for organization {org}.
        slots:
          org: path.organization-id
      - text: Reset tenant {org} to no custom branding by deleting its default branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update the default organizational branding
      effect: write
      questions:
      - How do I change our default sign-in branding properties?
      - Can I edit the localizations attached to the default branding object?
      instructions:
      - text: Update the default branding of organization {org}.
        slots:
          org: path.organization-id
      - text: Patch the default company branding for {org} with localizations {localizations}.
        slots:
          org: path.organization-id
          localizations: requestBody.localizations
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/backgroundImage'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the default sign-in background image
      effect: read
      questions:
      - What background picture is shown behind our default sign-in page?
      - Can I fetch the full-screen backdrop image from the default branding?
      instructions:
      - text: Download the default sign-in page background image for organization {org}.
        slots:
          org: path.organization-id
      - text: Fetch the backdrop picture used by tenant {org}'s default branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/backgroundImage'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload the default sign-in background image
      effect: write
      questions:
      - What size limits apply to a sign-in background image, like the 1920 × 1080 maximum?
      - Can I replace the full-page backdrop on our default sign-in screen with a JPEG?
      instructions:
      - text: Upload a new default sign-in background image for organization {org}.
        slots:
          org: path.organization-id
      - text: Replace the backdrop photo in tenant {org}'s default branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/backgroundImage'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove the default sign-in background image
      effect: destructive
      questions:
      - Can I get rid of the custom background on our default sign-in page?
      - Is removing the default backdrop image needed before deleting branding?
      instructions:
      - text: Remove the default sign-in background image from organization {org}.
        slots:
          org: path.organization-id
      - text: Clear the backdrop picture out of tenant {org}'s default branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/bannerLogo'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the default banner logo
      effect: read
      questions:
      - Which banner version of our company logo appears on the default sign-in page?
      - Can I retrieve the wide banner logo from our base company branding?
      instructions:
      - text: Download the default banner logo for organization {org}.
        slots:
          org: path.organization-id
      - text: Get the wide company banner image from tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/bannerLogo'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload the default banner logo
      effect: write
      questions:
      - What dimensions are allowed for a sign-in banner logo, like the 36 × 245 limit?
      - Can I swap in a transparent banner logo for our base branding?
      instructions:
      - text: Upload a new default banner logo for organization {org}.
        slots:
          org: path.organization-id
      - text: Replace the wide company banner in tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/bannerLogo'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove the default banner logo
      effect: destructive
      questions:
      - Can I drop the banner logo from our default sign-in branding?
      - What happens to the sign-in page if the base banner logo is deleted?
      instructions:
      - text: Remove the default banner logo from organization {org}.
        slots:
          org: path.organization-id
      - text: Delete the wide company banner out of tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/customCSS'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the default sign-in custom CSS
      effect: read
      questions:
      - What custom stylesheet is applied to our default sign-in page?
      - Can I pull down the CSS file from the base company branding to edit it?
      instructions:
      - text: Download the default custom CSS for organization {org}'s sign-in page.
        slots:
          org: path.organization-id
      - text: Get the stylesheet used by tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/customCSS'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload the default sign-in custom CSS
      effect: write
      questions:
      - Is there a size limit on sign-in page CSS, such as 25 KB?
      - Can I restyle our default sign-in page by uploading a .css file?
      instructions:
      - text: Upload new default custom CSS for organization {org}'s sign-in page.
        slots:
          org: path.organization-id
      - text: Replace the stylesheet in tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/customCSS'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove the default sign-in custom CSS
      effect: destructive
      questions:
      - Can I go back to the stock look by removing our default sign-in CSS?
      - Will deleting the base branding stylesheet affect localized branding?
      instructions:
      - text: Remove the default custom CSS from organization {org}.
        slots:
          org: path.organization-id
      - text: Delete the stylesheet out of tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/favicon'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the default favicon
      effect: read
      questions:
      - What browser tab icon does our default Entra branding use?
      - Can I retrieve the custom favicon that replaces the Microsoft default?
      instructions:
      - text: Download the default favicon for organization {org}.
        slots:
          org: path.organization-id
      - text: Get the browser tab icon from tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/favicon'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload the default favicon
      effect: write
      questions:
      - Can I replace the Microsoft favicon on our tenant with our own icon?
      - Where do I upload a custom browser tab icon for the base branding?
      instructions:
      - text: Upload a new default favicon for organization {org}.
        slots:
          org: path.organization-id
      - text: Swap the browser tab icon in tenant {org}'s base branding for our own.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/favicon'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove the default favicon
      effect: destructive
      questions:
      - Can I restore the standard Microsoft favicon by deleting ours?
      - Is it possible to drop the custom tab icon from the base branding?
      instructions:
      - text: Remove the default favicon from organization {org}.
        slots:
          org: path.organization-id
      - text: Delete the custom browser tab icon out of tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/headerLogo'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the default header logo
      effect: read
      questions:
      - Which logo shows in the header strip of our default sign-in page?
      - Can I retrieve the header company logo from the base branding?
      instructions:
      - text: Download the default header logo for organization {org}.
        slots:
          org: path.organization-id
      - text: Get the page-header company logo from tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/headerLogo'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload the default header logo
      effect: write
      questions:
      - What file types are accepted for the logo in the sign-in page header?
      - Can I put our logo in the header area of the default sign-in screen?
      instructions:
      - text: Upload a new default header logo for organization {org}.
        slots:
          org: path.organization-id
      - text: Replace the page-header company logo in tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/headerLogo'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove the default header logo
      effect: destructive
      questions:
      - Can I take our logo out of the default sign-in page header?
      - Is deleting the base header logo reversible by uploading a new one later?
      instructions:
      - text: Remove the default header logo from organization {org}.
        slots:
          org: path.organization-id
      - text: Delete the page-header company logo out of tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List branding localizations
      effect: read
      questions:
      - Which languages have their own sign-in branding in our tenant?
      - Does the list of branding localizations include the default one?
      instructions:
      - text: List every branding localization for organization {org}.
        slots:
          org: path.organization-id
      - text: Show the first {top} localized brandings of tenant {org}.
        slots:
          org: path.organization-id
          top: query.$top
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a localized branding
      effect: write
      questions:
      - How do I add sign-in branding for a specific browser language?
      - Does creating a localized branding also create the default branding if it's missing?
      instructions:
      - text: Create a new language-specific branding for organization {org}.
        slots:
          org: path.organization-id
      - text: Add a localized sign-in branding to tenant {org}.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one localized branding
      effect: read
      questions:
      - What sign-in text is configured for one particular language's branding?
      - Can I read a localized branding by its locale ID?
      instructions:
      - text: Get the {locale} branding localization of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Show the properties of localized branding {locale} for tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a localized branding
      effect: destructive
      questions:
      - Can I remove the branding for a single language?
      - Must the images be removed from a localized branding before deleting it?
      instructions:
      - text: Delete the {locale} branding localization from organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Drop localized branding {locale} in tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a localized branding
      effect: write
      questions:
      - How do I change the sign-in text for one language's branding?
      - Can I edit a single locale's branding without touching the default?
      instructions:
      - text: Update the {locale} branding localization of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Edit properties of localized branding {locale} in tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/backgroundImage'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a localized sign-in background image
      effect: read
      questions:
      - What backdrop picture is shown for users signing in in a specific language?
      - Can I fetch the background image of one localized branding?
      instructions:
      - text: Download the translated sign-in background image for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Fetch the language-specific backdrop in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/backgroundImage'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a localized sign-in background image
      effect: write
      questions:
      - Can each language have its own sign-in background photo?
      - Do localized backdrop uploads follow the same PNG or JPEG size limits?
      instructions:
      - text: Upload the translated sign-in background image for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Set a language-specific backdrop on localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/backgroundImage'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a localized sign-in background image
      effect: destructive
      questions:
      - Can I clear the backdrop from just one language's branding?
      - Should I delete a localization's background image before deleting the localization?
      instructions:
      - text: Remove the translated sign-in background image from the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Clear the language-specific backdrop in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/bannerLogo'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a localized banner logo
      effect: read
      questions:
      - Which banner logo do users see when signing in in a particular language?
      - Can I retrieve the banner logo from a single localization?
      instructions:
      - text: Download the translated banner logo for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Get the language-specific wide banner in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/bannerLogo'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a localized banner logo
      effect: write
      questions:
      - Can I give one language its own banner logo on the sign-in page?
      - Is a translated banner logo uploaded per localization?
      instructions:
      - text: Upload the translated banner logo for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Set a language-specific wide banner on localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/bannerLogo'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a localized banner logo
      effect: destructive
      questions:
      - Can I delete the banner logo from one language's branding only?
      - Does removing a localized banner logo fall back to the default one?
      instructions:
      - text: Remove the translated banner logo from the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Delete the language-specific wide banner in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/customCSS'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a localized sign-in custom CSS
      effect: read
      questions:
      - What stylesheet applies to the sign-in page for a given language?
      - Can I download the CSS attached to one localization?
      instructions:
      - text: Download the translated custom CSS for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Get the language-specific stylesheet in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/customCSS'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a localized sign-in custom CSS
      effect: write
      questions:
      - Can I style the sign-in page differently for one language with its own CSS?
      - Does the 25 KB CSS limit apply to each localization's stylesheet too?
      instructions:
      - text: Upload translated custom CSS for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Set a language-specific stylesheet on localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/customCSS'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a localized sign-in custom CSS
      effect: destructive
      questions:
      - Can I strip the custom CSS from a single language's sign-in branding?
      - Is it possible to delete one locale's stylesheet but keep the default CSS?
      instructions:
      - text: Remove the translated custom CSS from the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Delete the language-specific stylesheet in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/favicon'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a localized favicon
      effect: read
      questions:
      - Which tab icon is used for one language's sign-in branding?
      - Can I retrieve the favicon of a specific localization?
      instructions:
      - text: Download the translated favicon for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Get the language-specific tab icon in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/favicon'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a localized favicon
      effect: write
      questions:
      - Can a single language's branding carry its own favicon?
      - Is uploading a per-locale tab icon supported?
      instructions:
      - text: Upload the translated favicon for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Set a language-specific tab icon on localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/favicon'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a localized favicon
      effect: destructive
      questions:
      - Can I delete the favicon from just one localization?
      - What icon shows after a locale's custom favicon is removed?
      instructions:
      - text: Remove the translated favicon from the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Delete the language-specific tab icon in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/headerLogo'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a localized header logo
      effect: read
      questions:
      - Which header logo appears on the sign-in page for a specific language?
      - Can I fetch one localization's page-header logo?
      instructions:
      - text: Download the translated header logo for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Get the language-specific page-header logo in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/headerLogo'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a localized header logo
      effect: write
      questions:
      - Can I show a different header logo to users of one language?
      - Is a per-locale header logo limited to PNG or JPEG?
      instructions:
      - text: Upload the translated header logo for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Set a language-specific page-header logo on localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/headerLogo'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a localized header logo
      effect: destructive
      questions:
      - Can I take the header logo out of one language's branding?
      - Is it possible to clear a locale's header logo while keeping its other images?
      instructions:
      - text: Remove the translated header logo from the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Delete the language-specific page-header logo in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/squareLogo'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a localized square logo
      effect: read
      questions:
      - Which square logo appears in Windows Autopilot setup for a particular language?
      - Can I retrieve the light square logo from one localization?
      instructions:
      - text: Download the translated square logo for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Get the language-specific Windows OOBE logo in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/squareLogo'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a localized square logo
      effect: write
      questions:
      - Can each language get its own square logo for Windows out-of-box experience screens?
      - Is a per-locale square logo capped at 240 x 240 pixels and 10 KB?
      instructions:
      - text: Upload the translated square logo for the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Set a language-specific Windows OOBE logo on localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/squareLogo'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a localized square logo
      effect: destructive
      questions:
      - Can I remove the square Autopilot logo from one language's branding?
      - Does deleting a locale's light square logo leave the dark variant in place?
      instructions:
      - text: Remove the translated square logo from the {locale} locale of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Delete the language-specific Windows OOBE logo in localization {locale} of tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/squareLogoDark'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a localized dark square logo
      effect: read
      questions:
      - What dark-theme square logo does a given language show during Windows setup?
      - Can I pull the dark variant of the square logo for one locale?
      instructions:
      - text: Download the dark-mode square logo in the {locale} branding of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Fetch localization {locale}'s dark Autopilot icon for tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/squareLogoDark'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a localized dark square logo
      effect: write
      questions:
      - Can I provide a dark version of the square logo for a single language?
      - Which image formats work for a locale's dark-theme Autopilot logo?
      instructions:
      - text: Upload a dark-mode square logo into the {locale} branding of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Replace localization {locale}'s dark Autopilot icon for tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/squareLogoDark'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a localized dark square logo
      effect: destructive
      questions:
      - Can I delete just the dark square logo from one language's branding?
      - Is removing a locale's dark-theme Windows logo independent of the light one?
      instructions:
      - text: Remove the dark-mode square logo from the {locale} branding of organization {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      - text: Clear localization {locale}'s dark Autopilot icon for tenant {org}.
        slots:
          locale: path.organizationalBrandingLocalization-id
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/localizations/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count branding localizations
      effect: read
      questions:
      - How many languages have localized sign-in branding configured?
      - Can I count branding localizations matching a filter?
      instructions:
      - text: Count the branding localizations of organization {org}.
        slots:
          org: path.organization-id
      - text: Tell me how many localized brandings in tenant {org} match {filter}.
        slots:
          org: path.organization-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/squareLogo'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the default square logo
      effect: read
      questions:
      - Which square logo shows in Windows 10 out-of-box setup for our tenant by default?
      - Can I retrieve the standard light square logo from base branding?
      instructions:
      - text: Download the default square logo for organization {org}.
        slots:
          org: path.organization-id
      - text: Get the Windows OOBE logo from tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/squareLogo'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload the default square logo
      effect: write
      questions:
      - What are the limits for the Autopilot square logo, like 240 x 240 pixels and 10 KB?
      - Can I set the square logo used by default when Windows Autopilot is enabled?
      instructions:
      - text: Upload a new default square logo for organization {org}.
        slots:
          org: path.organization-id
      - text: Replace the Windows OOBE logo in tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/squareLogo'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove the default square logo
      effect: destructive
      questions:
      - Can I remove the square logo shown during default Windows setup?
      - Does deleting the base light square logo also remove the dark one?
      instructions:
      - text: Remove the default square logo from organization {org}.
        slots:
          org: path.organization-id
      - text: Delete the Windows OOBE logo out of tenant {org}'s base branding.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/squareLogoDark'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the default dark square logo
      effect: read
      questions:
      - What dark-theme square logo does our tenant show by default in Windows setup?
      - Can I pull the dark variant of the base square logo?
      instructions:
      - text: Download the dark-mode square logo in organization {org}'s default branding.
        slots:
          org: path.organization-id
      - text: Fetch the base dark Autopilot icon for tenant {org}.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/squareLogoDark'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload the default dark square logo
      effect: write
      questions:
      - Can I supply a dark version of our square logo for default Windows out-of-box screens?
      - Is there a size cap on the base dark-theme Autopilot logo?
      instructions:
      - text: Upload a dark-mode square logo into organization {org}'s default branding.
        slots:
          org: path.organization-id
      - text: Replace the base dark Autopilot icon for tenant {org}.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/branding/squareLogoDark'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove the default dark square logo
      effect: destructive
      questions:
      - Can I delete only the dark square logo from our base branding?
      - Is the default dark-theme Windows logo removable on its own?
      instructions:
      - text: Remove the dark-mode square logo from organization {org}'s default branding.
        slots:
          org: path.organization-id
      - text: Clear the base dark Autopilot icon for tenant {org}.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'