Backstage
Backstage is an open-source developer portal platform created by Spotify. It provides a centralized software catalog, software templates (scaffolder), TechDocs, and a plugin ecosystem for building customizable developer portals. Backstage helps organizations manage their software ecosystem by cataloging services, APIs, resources, and infrastructure, and provides tooling for creating new projects from templates.
Backstage publishes 23 APIs on the APIs.io network, including Actions API, Authentication API, Authorization API, and 20 more. Tagged areas include Developer Portal, Internal Developer Platform, Software Catalog, Open Source, and Platform Engineering.
The Backstage catalog on APIs.io includes 2 event-driven AsyncAPI specifications, 1 JSON-LD context, and 3 Spectral governance rulesets.
Backstage’s developer surface includes sandbox, changelog, CLI, API reference, support, authentication, documentation, and 38 more developer resources.
Kin Score
What adopting Backstage moves on the Kin Score 3
Backstage is an area vendor: providers adopt it to run part of their developer surface. This is the Kin Score checks its features can move for a provider that adopts it, what each one really earns, and what it earns nothing for.
Backstage is built for internal engineering: a catalog of services and APIs (openapi, asyncapi, graphql, grpc definitions), TechDocs and scaffolding, all inside a client-side React app that usually sits behind single sign-on. None of that is the public surface the Kin Score reads. The portal, documentation and reference pointers are reachable only by the rare provider that runs a public, unauthenticated Backstage and declares it, and even then the React shell hides content from non-JavaScript readers. Its MCP actions backend exposes Backstage’s own actions behind backend auth, not the provider’s API. Backstage matters to a public score only indirectly, by keeping the internal contracts a provider later publishes in order.
| Check | Earns | Through |
|---|---|---|
| Documentationsaturated Developer ErgonomicsOnly when TechDocs are public and declared as Documentation. Behind SSO, the score never sees them. |
4.0 of 4 | TechDocs |
| API referencesaturated Developer ErgonomicsOnly when an API entity’s rendered definition is public and declared as an APIReference. The React app renders client-side, so a non-JavaScript reader sees a shell. |
3.0 of 3 | Software Catalog with API entities |
| Developer portalconditional Developer ErgonomicsOnly for a Backstage instance served publicly without SSO and declared as the provider’s DeveloperPortal. Almost every deployment is internal. |
4.0 of 4 | Internal developer portal framework |
What Backstage ships that earns nothing (3)
- MCP Actions Backend — The tools are Backstage’s own registered actions behind backend auth, not the provider’s API.
- Software Catalog with API entities — An API entity stores a definition inside the catalog. It is not a published contract until the provider publishes the OpenAPI itself.
- Software Catalog with API entities — A catalog-info.yaml is Backstage’s descriptor, not an APIs.json index.
A model, not a score. Adopting this vendor changes a provider's Kin Score only when the provider publishes the resulting artifacts on its own surface; nothing here writes a score, and no sponsorship or partnership can. The rating is not for sale → · Full vendor facets artifact
APIs 23
Individual APIs this provider publishes, each with its own machine-readable definition.
Backstage Actions API
Endpoints for listing available scaffolder actions.
Backstage Authentication API
The Authentication API from Backstage — 4 operation(s) for authentication.
Backstage Authorization API
The Authorization API from Backstage — 2 operation(s) for authorization.
Backstage Documentation API
The Documentation API from Backstage — 2 operation(s) for documentation.
Backstage Locations API
Endpoints for managing catalog locations (entity sources).
Backstage Metadata API
The Metadata API from Backstage — 2 operation(s) for metadata.
Backstage Search API
The Search API from Backstage — 1 operation(s) for search.
Backstage Sync API
The Sync API from Backstage — 1 operation(s) for sync.
Backstage Tasks API
Endpoints for creating and managing scaffolder tasks.
Backstage Templates API
Endpoints for template metadata and parameter schemas.
Backstage Token Verification API
The Token Verification API from Backstage — 1 operation(s) for token verification.
Backstage Autocomplete API
The Autocomplete API from Backstage — 1 operation(s) for autocomplete.
Backstage Bus API
The Bus API from Backstage — 3 operation(s) for bus.
Backstage Dry Run API
The Dry Run API from Backstage — 1 operation(s) for dry run.
Backstage Entity API
The Entity API from Backstage — 9 operation(s) for entity.
Backstage Notifications API
The Notifications API from Backstage — 5 operation(s) for notifications.
Backstage Provider API
List of endpoints per provider
Backstage Remotes API
The Remotes API from Backstage — 1 operation(s) for remotes.
Backstage Settings API
The Settings API from Backstage — 1 operation(s) for settings.
Backstage Status API
The Status API from Backstage — 1 operation(s) for status.
Backstage Templating Extensions API
The Templating Extensions API from Backstage — 1 operation(s) for templating extensions.
Backstage Topics API
The Topics API from Backstage — 1 operation(s) for topics.
Backstage Update API
The Update API from Backstage — 1 operation(s) for update.
Scroll for all 23
Open Collections 19
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
API Collection
OPEN COLLECTIONBackstage Auth Actions API
OPEN COLLECTIONBackstage Auth API
OPEN COLLECTIONBackstage Auth Actions Authentication API
OPEN COLLECTIONBackstage Auth Actions Authorization API
OPEN COLLECTIONBackstage Catalog API
OPEN COLLECTIONBackstage Auth Actions Documentation API
OPEN COLLECTIONBackstage Auth Actions Entities API
OPEN COLLECTIONBackstage Auth Actions Locations API
OPEN COLLECTIONBackstage Auth Actions Metadata API
OPEN COLLECTIONBackstage Permissions API
OPEN COLLECTIONBackstage Scaffolder API
OPEN COLLECTIONBackstage Auth Actions Search API
OPEN COLLECTIONBackstage Search API
OPEN COLLECTIONBackstage Auth Actions Sync API
OPEN COLLECTIONBackstage Auth Actions Tasks API
OPEN COLLECTIONBackstage TechDocs API
OPEN COLLECTIONBackstage Auth Actions Templates API
OPEN COLLECTIONBackstage Auth Actions Token Verification API
OPEN COLLECTIONScroll for all 19
MCP Servers 1
Model Context Protocol servers that expose these APIs to AI agents.
Backstage MCP Actions Backend
Backstage ships a first-party MCP server as the @backstage/plugin-mcp-actions-backend plugin. It exposes every action registered with the Backstage Actions Registry as an MCP to...
MCP SERVERPricing Plans 1
Published pricing tiers and plan structures.
Rate Limits 1
Documented rate limits and quota policies.
Backstage Rate Limits
RATE LIMITSFinOps 1
Cost, billing, and metering signals for API financial operations.
Backstage Finops
FINOPSFeatures 7
Notable capabilities this provider offers.
Software Catalog
Central inventory of all software components, APIs, resources, systems, domains, groups, and users.
Software Templates (Scaffolder)
Bootstrap new projects, services, and components from customizable templates.
TechDocs
Render and serve MkDocs-based technical documentation alongside catalog entities.
Plugin Ecosystem
Extensible plugin architecture with 100+ open-source plugins for CI/CD, monitoring, cloud, and more.
Search
Full-text search across catalog entities, TechDocs, and any other indexed content.
Permissions Framework
Policy-based authorization with conditional rules for resource-level access control.
Entity Relations
Model ownership, dependencies, and API consumption relationships between services.
Scroll for all 7
Event Specifications 2
AsyncAPI definitions for this provider's event-driven and streaming APIs.
Backstage Events System
The Backstage Events system provides a publish-subscribe mechanism for broadcasting and consuming events within a Backstage instance. It enables plugins to emit events when sign...
ASYNCAPIBackstage Webhooks
ASYNCAPISemantic Vocabularies 1
JSON-LD contexts and semantic vocabularies used across these APIs.
Backstage Context
JSON-LDSpectral Rules 3
Spectral governance rulesets for linting and validating these APIs.
JSON Schema 16
Standalone JSON Schema definitions for this provider's data models.
AuthResponse
JSON SCHEMAJwksResponse
JSON SCHEMABackstage Catalog Entity
JSON SCHEMAEntityMetadata
JSON SCHEMAEntityRelation
JSON SCHEMAEntity
JSON SCHEMALocation
JSON SCHEMAConditionalRequest
JSON SCHEMAPermissionDecision
JSON SCHEMAPermissionRequest
JSON SCHEMAAction
JSON SCHEMATask
JSON SCHEMASearchDocument
JSON SCHEMASearchResult
JSON SCHEMASearchResultSet
JSON SCHEMATechDocsMetadata
JSON SCHEMAScroll for all 16
JSON Structure 16
JSON Structure definitions describing this provider's data shapes.
Auth Auth Response Structure
JSON STRUCTUREAuth Jwks Response Structure
JSON STRUCTUREBackstage Entity Structure
JSON STRUCTURECatalog Entity Metadata Structure
JSON STRUCTURECatalog Entity Relation Structure
JSON STRUCTURECatalog Entity Structure
JSON STRUCTURECatalog Location Structure
JSON STRUCTUREPermissions Conditional Request Structure
JSON STRUCTUREPermissions Permission Decision Structure
JSON STRUCTUREPermissions Permission Request Structure
JSON STRUCTUREScaffolder Action Structure
JSON STRUCTUREScaffolder Task Structure
JSON STRUCTURESearch Search Document Structure
JSON STRUCTURESearch Search Result Set Structure
JSON STRUCTURESearch Search Result Structure
JSON STRUCTURETechdocs Tech Docs Metadata Structure
JSON STRUCTUREScroll for all 16
Examples 16
Example request and response payloads for these APIs.
Auth Auth Response Example
EXAMPLEAuth Jwks Response Example
EXAMPLEBackstage Entity Example
EXAMPLECatalog Entity Example
EXAMPLECatalog Location Example
EXAMPLEScaffolder Action Example
EXAMPLEScaffolder Task Example
EXAMPLESearch Search Result Example
EXAMPLEScroll for all 16
Security Posture 3
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Scopes 1
OAuth scopes governing access to this provider's APIs.
Agentic Access 1
Recommended x-agentic-access execution contracts for AI agents.
Use Cases 4
What developers build with this provider.
Internal Developer Portal
Build a unified portal for developers to discover services, read docs, and scaffold projects.
Service Catalog
Maintain a complete, up-to-date inventory of all microservices, APIs, and infrastructure.
Developer Onboarding
Accelerate new developer onboarding with self-service project scaffolding and documentation.
API Governance
Track all internal and external APIs, their owners, and documentation in one place.
Integrations 6
Pre-built integrations with other platforms and tools.
GitHub
Catalog ingestion from GitHub repos, GitHub Actions integration for CI/CD visibility.
PagerDuty
Show on-call information and incident status on catalog entity pages.
Kubernetes
Display Kubernetes workload status for catalog entities.
Prometheus
Show metrics and alerts for services directly in the catalog.
Snyk
Display security vulnerability information for catalog entities.
Datadog
Surface monitoring dashboards within Backstage.
Resources
Get Started 3
Portal, sign-up, and the first successful call
Documentation 3
Reference material describing how the API behaves
Agent Surfaces 5
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 10
Pagination, idempotency, versioning, errors, and events
Scroll for all 10
Build 6
SDKs, sample code, and the tooling you integrate with
Access & Security 5
Authentication, authorization, and security posture
Operate 6
Status, limits, changes, and where to get help
Company 2
The organization behind the API
Other 5
Properties that don't map to a standard resource type
Source (apis.yml)
Work with this as data
Every provider here is available over the APIs.io API and to AI agents over MCP.