Skip to content

Update docs for October 2026: auth, MCP connectors, new endpoints and STE rewrite - #67

Open
ErikBernskiold wants to merge 23 commits into
mainfrom
docs/october-2026-update
Open

ErikBernskiold wants to merge 23 commits into
mainfrom
docs/october-2026-update

Conversation

@ErikBernskiold

Copy link
Copy Markdown
Collaborator

Brings the developer docs up to date with The Fount as of October 2026, and rewrites the docs in ASD-STE100 Simplified Technical English.

What changed

Authentication

  • Rewrote Getting Started > Authentication for applications, personal and application API keys, OAuth 2 (authorization code and client credentials), acting on behalf of users, IP restrictions, errors and scopes.
  • Recommends OAuth over long-lived keys.

MCP connectors

  • Renamed the sidebar section to "MCP Connectors".
  • New pages: Concepts, Connecting Clients (Claude, ChatGPT, WPP Open, Microsoft 365 Copilot), MCP Apps and Market Share.
  • Updated the BAV, Best Countries and Financial Data tool lists, and the access and authorization page.
  • Updated the Social Data (Sightly) page from Sightly's documentation.

Brand Data and Tools

  • Brand Data now covers brandscape data and the data models (POST /brandscape/...).
  • The tools (/tools/...) have their own sidebar section and overview page.
  • Tool page URLs are unchanged.

New REST sections and pages

  • New sections: Audience Origin, Market Share, and Measures & Questions.
  • New pages:
    • Managing Audiences
    • Brand Tags and Brand Variations
    • Best Countries Models and Raw Data
    • Country Indicators
  • Rewrote Stock Prices.
  • Fixed many existing pages to match the app (fields, filters, includes, defaults).

Navigation

  • Removed Embed from the navbar and homepage. Its URLs still work.

Blog

  • 17 posts for the API and MCP releases since February 2026.

Style and fixes

  • Rewrote all current docs in Simplified Technical English. Code, headings, links and field names are unchanged.
  • Fixed the Python SDK docs to match the bavapi source.
  • Fixed all broken links and anchors.
  • Moved the support e-mail to bavsupport@wpp.com.

Suggested review order

  1. docs/authentication.md and docs/ai/mcp/
  2. docs/brand-data/ (overview, data models, tools)
  3. New REST sections
  4. blog/

Notes

  • Merging to main deploys straight to GitHub Pages, and the backfilled blog posts go live together.
  • Endpoints that currently return 400 or empty data, and webhook events that are not sent, are left out.

🤖 Generated with Claude Code

ErikBernskiold and others added 23 commits October 23, 2026 23:18
Bring the BAV, Best Countries and Financial Data pages up to date with the tools the
servers register, add Market Share, concepts, MCP Apps and connecting clients pages,
and update the Social Data page from Sightly's documentation.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Correct scopes, stock prices, brandscape data, the health check, webhooks and the
fields, filters and includes on existing endpoint pages to match the API.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Add pages for Market Share, brandscape models, Audience Origin, managing audiences,
measures and questions, brand tags and variations, country indicators and the
remaining Best Countries endpoints.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The embed pages stay published so existing links keep working.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Keep brandscape data, data models and tools in one section, and explain the
difference on the Brand Data overview.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…hnical English

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… Simplified Technical English

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s docs in Simplified Technical English

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ble endpoints

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant