ADadcontextprotocol
Brand Resolution

Set up a hosted brand.json

Changed on

Create or update a hosted brand.json for a domain owned by the authenticated user's organization. Returns the hosted URL and a pointer snippet for DNS setup.

post/api/brands/setup-my-brand

Request

  • Base URL
    https://agenticadvertising.org
  • URL
    https://agenticadvertising.org/api/brands/setup-my-brand
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://agenticadvertising.org/authorize
      Token URL: https://agenticadvertising.org/token

Request body

domainstring required
brand_namestring required
brand_jsonobject

Optional full brand.json draft to host in the registry. Every recognized logo URL must be an absolute HTTPS URL of at most 2048 characters without userinfo credentials, backslashes, or markup-significant characters. The primary brand color must use #RRGGBB format.

logo_urlstring uri

Absolute HTTPS URL for the brand logo. Userinfo credentials, backslashes, and markup-significant characters are not allowed.

brand_colorstring

Example request

{
  "domain": "acmecorp.com",
  "logo_url": "https://cdn.example.com/brand/logo.svg"
}

Response

Brand setup result

domainstring required
has_brand_jsonboolean required
hosted_brand_json_urlstring required
pointer_snippetstring required

JSON string for brand.json pointer

Changes

  • 230de8f6a73eRevision changes
    • breaking

      added the pattern ^#[0-9a-fA-F]{6}$ to the request property

    • breaking

      the request property format changed from no format to uri

    • warning

      the request property's maxLength was set to 2048

  • 3ee07db2cb34Revision changes
    • info

      added the new optional request property