Microsoft Entra ID (formerly Azure AD)

Microsoft Entra ID (formerly Azure AD) Organization.organizational Branding API

The organization.organizationalBranding API from Microsoft Entra ID (formerly Azure AD) — 18 operation(s) for organization.organizationalbranding.

GitHub OpenAPI

Operations 51

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /organization/{organization-id}/branding Get the organization's default sign-in branding · Get organizationalBranding #
Ask an LLM
“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?”
Tell an agent
Show the default sign-in branding for organization {org}.
Get company branding properties {select} for tenant {org}.
PATCH /organization/{organization-id}/branding Update the default organizational branding · Update organizationalBranding #
Ask an LLM
“How do I change our default sign-in branding properties?”
“Can I edit the localizations attached to the default branding object?”
Tell an agent
Update the default branding of organization {org}.
Patch the default company branding for {org} with localizations {localizations}.
DELETE /organization/{organization-id}/branding Delete the default organizational branding · Delete organizationalBranding #
Ask an LLM
“Can I wipe out our default company branding entirely?”
“Do I have to remove all the branding images before deleting the default branding?”
Tell an agent destructive · confirm first
Delete the default company branding object for organization {org}.
Reset tenant {org} to no custom branding by deleting its default branding.
GET /organization/{organization-id}/branding/backgroundImage Download the default sign-in background image · Get backgroundImage for the navigation property branding from organization #
Ask an LLM
“What background picture is shown behind our default sign-in page?”
“Can I fetch the full-screen backdrop image from the default branding?”
Tell an agent
Download the default sign-in page background image for organization {org}.
Fetch the backdrop picture used by tenant {org}'s default branding.
PUT /organization/{organization-id}/branding/backgroundImage Upload the default sign-in background image · Update backgroundImage for the navigation property branding in organization #
Ask an LLM
“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?”
Tell an agent
Upload a new default sign-in background image for organization {org}.
Replace the backdrop photo in tenant {org}'s default branding.
DELETE /organization/{organization-id}/branding/backgroundImage Remove the default sign-in background image · Delete backgroundImage for the navigation property branding in organization #
Ask an LLM
“Can I get rid of the custom background on our default sign-in page?”
“Is removing the default backdrop image needed before deleting branding?”
Tell an agent destructive · confirm first
Remove the default sign-in background image from organization {org}.
Clear the backdrop picture out of tenant {org}'s default branding.
GET /organization/{organization-id}/branding/customCSS Download the default sign-in custom CSS · Get customCSS for the navigation property branding from organization #
Ask an LLM
“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?”
Tell an agent
Download the default custom CSS for organization {org}'s sign-in page.
Get the stylesheet used by tenant {org}'s base branding.
PUT /organization/{organization-id}/branding/customCSS Upload the default sign-in custom CSS · Update customCSS for the navigation property branding in organization #
Ask an LLM
“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?”
Tell an agent
Upload new default custom CSS for organization {org}'s sign-in page.
Replace the stylesheet in tenant {org}'s base branding.
DELETE /organization/{organization-id}/branding/customCSS Remove the default sign-in custom CSS · Delete customCSS for the navigation property branding in organization #
Ask an LLM
“Can I go back to the stock look by removing our default sign-in CSS?”
“Will deleting the base branding stylesheet affect localized branding?”
Tell an agent destructive · confirm first
Remove the default custom CSS from organization {org}.
Delete the stylesheet out of tenant {org}'s base branding.
GET /organization/{organization-id}/branding/favicon Download the default favicon · Get favicon for the navigation property branding from organization #
Ask an LLM
“What browser tab icon does our default Entra branding use?”
“Can I retrieve the custom favicon that replaces the Microsoft default?”
Tell an agent
Download the default favicon for organization {org}.
Get the browser tab icon from tenant {org}'s base branding.
PUT /organization/{organization-id}/branding/favicon Upload the default favicon · Update favicon for the navigation property branding in organization #
Ask an LLM
“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?”
Tell an agent
Upload a new default favicon for organization {org}.
Swap the browser tab icon in tenant {org}'s base branding for our own.
DELETE /organization/{organization-id}/branding/favicon Remove the default favicon · Delete favicon for the navigation property branding in organization #
Ask an LLM
“Can I restore the standard Microsoft favicon by deleting ours?”
“Is it possible to drop the custom tab icon from the base branding?”
Tell an agent destructive · confirm first
Remove the default favicon from organization {org}.
Delete the custom browser tab icon out of tenant {org}'s base branding.
GET /organization/{organization-id}/branding/localizations List branding localizations · List localizations #
Ask an LLM
“Which languages have their own sign-in branding in our tenant?”
“Does the list of branding localizations include the default one?”
Tell an agent
List every branding localization for organization {org}.
Show the first {top} localized brandings of tenant {org}.
POST /organization/{organization-id}/branding/localizations Create a localized branding · Create organizationalBrandingLocalization #
Ask an LLM
“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?”
Tell an agent
Create a new language-specific branding for organization {org}.
Add a localized sign-in branding to tenant {org}.
GET /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id} Get one localized branding · Get organizationalBrandingLocalization #
Ask an LLM
“What sign-in text is configured for one particular language's branding?”
“Can I read a localized branding by its locale ID?”
Tell an agent
Get the {locale} branding localization of organization {org}.
Show the properties of localized branding {locale} for tenant {org}.
PATCH /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id} Update a localized branding · Update organizationalBrandingLocalization #
Ask an LLM
“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?”
Tell an agent
Update the {locale} branding localization of organization {org}.
Edit properties of localized branding {locale} in tenant {org}.
DELETE /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id} Delete a localized branding · Delete organizationalBrandingLocalization #
Ask an LLM
“Can I remove the branding for a single language?”
“Must the images be removed from a localized branding before deleting it?”
Tell an agent destructive · confirm first
Delete the {locale} branding localization from organization {org}.
Drop localized branding {locale} in tenant {org}.
GET /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/backgroundImage Download a localized sign-in background image · Get backgroundImage for the navigation property localizations from organization #
Ask an LLM
“What backdrop picture is shown for users signing in in a specific language?”
“Can I fetch the background image of one localized branding?”
Tell an agent
Download the translated sign-in background image for the {locale} locale of organization {org}.
Fetch the language-specific backdrop in localization {locale} of tenant {org}.
PUT /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/backgroundImage Upload a localized sign-in background image · Update backgroundImage for the navigation property localizations in organization #
Ask an LLM
“Can each language have its own sign-in background photo?”
“Do localized backdrop uploads follow the same PNG or JPEG size limits?”
Tell an agent
Upload the translated sign-in background image for the {locale} locale of organization {org}.
Set a language-specific backdrop on localization {locale} of tenant {org}.
DELETE /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/backgroundImage Remove a localized sign-in background image · Delete backgroundImage for the navigation property localizations in organization #
Ask an LLM
“Can I clear the backdrop from just one language's branding?”
“Should I delete a localization's background image before deleting the localization?”
Tell an agent destructive · confirm first
Remove the translated sign-in background image from the {locale} locale of organization {org}.
Clear the language-specific backdrop in localization {locale} of tenant {org}.
GET /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/customCSS Download a localized sign-in custom CSS · Get customCSS for the navigation property localizations from organization #
Ask an LLM
“What stylesheet applies to the sign-in page for a given language?”
“Can I download the CSS attached to one localization?”
Tell an agent
Download the translated custom CSS for the {locale} locale of organization {org}.
Get the language-specific stylesheet in localization {locale} of tenant {org}.
PUT /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/customCSS Upload a localized sign-in custom CSS · Update customCSS for the navigation property localizations in organization #
Ask an LLM
“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?”
Tell an agent
Upload translated custom CSS for the {locale} locale of organization {org}.
Set a language-specific stylesheet on localization {locale} of tenant {org}.
DELETE /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/customCSS Remove a localized sign-in custom CSS · Delete customCSS for the navigation property localizations in organization #
Ask an LLM
“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?”
Tell an agent destructive · confirm first
Remove the translated custom CSS from the {locale} locale of organization {org}.
Delete the language-specific stylesheet in localization {locale} of tenant {org}.
GET /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/favicon Download a localized favicon · Get favicon for the navigation property localizations from organization #
Ask an LLM
“Which tab icon is used for one language's sign-in branding?”
“Can I retrieve the favicon of a specific localization?”
Tell an agent
Download the translated favicon for the {locale} locale of organization {org}.
Get the language-specific tab icon in localization {locale} of tenant {org}.
PUT /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/favicon Upload a localized favicon · Update favicon for the navigation property localizations in organization #
Ask an LLM
“Can a single language's branding carry its own favicon?”
“Is uploading a per-locale tab icon supported?”
Tell an agent
Upload the translated favicon for the {locale} locale of organization {org}.
Set a language-specific tab icon on localization {locale} of tenant {org}.
DELETE /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/favicon Remove a localized favicon · Delete favicon for the navigation property localizations in organization #
Ask an LLM
“Can I delete the favicon from just one localization?”
“What icon shows after a locale's custom favicon is removed?”
Tell an agent destructive · confirm first
Remove the translated favicon from the {locale} locale of organization {org}.
Delete the language-specific tab icon in localization {locale} of tenant {org}.
GET /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/squareLogoDark Download a localized dark square logo · Get squareLogoDark for the navigation property localizations from organization #
Ask an LLM
“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?”
Tell an agent
Download the dark-mode square logo in the {locale} branding of organization {org}.
Fetch localization {locale}'s dark Autopilot icon for tenant {org}.
PUT /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/squareLogoDark Upload a localized dark square logo · Update squareLogoDark for the navigation property localizations in organization #
Ask an LLM
“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?”
Tell an agent
Upload a dark-mode square logo into the {locale} branding of organization {org}.
Replace localization {locale}'s dark Autopilot icon for tenant {org}.
DELETE /organization/{organization-id}/branding/localizations/{organizationalBrandingLocalization-id}/squareLogoDark Remove a localized dark square logo · Delete squareLogoDark for the navigation property localizations in organization #
Ask an LLM
“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?”
Tell an agent destructive · confirm first
Remove the dark-mode square logo from the {locale} branding of organization {org}.
Clear localization {locale}'s dark Autopilot icon for tenant {org}.
GET /organization/{organization-id}/branding/localizations/$count Count branding localizations · Get the number of the resource #
Ask an LLM
“How many languages have localized sign-in branding configured?”
“Can I count branding localizations matching a filter?”
Tell an agent
Count the branding localizations of organization {org}.
Tell me how many localized brandings in tenant {org} match {filter}.
GET /organization/{organization-id}/branding/squareLogoDark Download the default dark square logo · Get squareLogoDark for the navigation property branding from organization #
Ask an LLM
“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?”
Tell an agent
Download the dark-mode square logo in organization {org}'s default branding.
Fetch the base dark Autopilot icon for tenant {org}.
PUT /organization/{organization-id}/branding/squareLogoDark Upload the default dark square logo · Update squareLogoDark for the navigation property branding in organization #
Ask an LLM
“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?”
Tell an agent
Upload a dark-mode square logo into organization {org}'s default branding.
Replace the base dark Autopilot icon for tenant {org}.
DELETE /organization/{organization-id}/branding/squareLogoDark Remove the default dark square logo · Delete squareLogoDark for the navigation property branding in organization #
Ask an LLM
“Can I delete only the dark square logo from our base branding?”
“Is the default dark-theme Windows logo removable on its own?”
Tell an agent destructive · confirm first
Remove the dark-mode square logo from organization {org}'s default branding.
Clear the base dark Autopilot icon for tenant {org}.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview
📖
Authentication
https://learn.microsoft.com/en-us/graph/auth/
📖
Documentation
https://learn.microsoft.com/en-us/graph/change-notifications-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-organization-organizationalbranding-api-openapi.yml

Other Resources

🔗
SDKs
https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
🔗
ChangeLog
https://developer.microsoft.com/en-us/graph/changelog
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/asyncapi/azure-ad-change-notifications-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/azure-ad:azure-ad-organization-organizationalbranding-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

azure-ad-organization-organizationalbranding-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Identity.DirectoryManagement Organization.organizational…
  version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
  description: Core
security:
- azureaadv2: []
tags:


# --- truncated at 32 KB (96 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-organization-organizationalbranding-api-openapi.yml