Backstage 1.54 expands AI resources and tightens authentication boundaries
The release adds agent-oriented catalog types while requiring migration work for connection APIs and some OAuth allowlist patterns.
Backstage 1.54.0 adds agent-oriented catalog primitives, changes the connections API, and tightens OAuth redirect matching. The upstream release shipped on Aug. 18, 2026; its versioned changelog marks several changes as breaking.
What changed
The alpha AiResource catalog kind now supports marketplace and plugin specification types. A marketplace can describe a curated registry of plugins, while a plugin can group skills; skill specifications can also declare allowed tools, license and compatibility metadata aligned with agentskills.io. The same changelog promotes root system metadata to a stable backend service and adds a catalog action that lets agents and MCP clients request an immediate refresh of one entity.
Authentication and connection handling changed as well. OAuth redirect and client-metadata allowlists now match URL components separately, reject patterns without an explicit protocol, and no longer let wildcards span host and path boundaries. The @backstage/connections package became a common library, connection lookups now accept typed query objects, and several backend-only exports were removed.
Who it affects
Platform teams using custom OAuth allowlist patterns should validate those patterns before upgrading. Plugin developers that import backend-only connection APIs or call connection lookups with a bare URL need code changes. Teams experimenting with agent catalogs gain new schema options, but the AiResource additions remain alpha rather than a stable compatibility promise.
What to do
Run the Backstage upgrade helper for 1.54.0, then review the changelog sections for @backstage/plugin-auth-backend, @backstage/connections, @backstage/frontend-plugin-api and @backstage/repo-tools. Test explicit OAuth redirect patterns, migrate connection calls to { type, query, authMethods }, and treat the new AI resource schemas as experimental until their APIs stabilize.
sources
- Backstage v1.54.0 releasegithub.com
- Backstage 1.54.0 versioned changeloggithub.com
- Backstage upgrade helper for 1.54.0backstage.github.io
comments · 0