Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Roadie TechDocs API

Technical documentation (docs-like-code) metadata and static content. Modeled from Backstage.

Roadie TechDocs API is one of 6 APIs that Roadie publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include TechDocs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 2 paths, and defines 1 schema. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://api.roadie.so/api.

2 operations 2 paths 1 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://api.roadie.so/api/catalog
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Roadie TechDocs API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Roadie API token (User Token or Service Token) created under Administration in the Roadie app. Passed as Authorization: Bearer YOURROADIEAPITOKEN.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

TechDocs 2

Technical documentation (docs-like-code) metadata and static content. Modeled from Backstage.

GET
/techdocs/metadata/entity/{namespace}/{kind}/{name}
Get TechDocs metadata for an entity
getTechDocsMetadata 3 params → 200401404
GET
/techdocs/static/docs/{namespace}/{kind}/{name}/{path}
Get a static TechDocs asset
getTechDocsStatic 4 params → 200401404

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is Error (1 property). Each schema is shown below with its type and property counts.

Error
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

roadie-io-techdocs-api-openapi.yml Raw ↑

Other APIs Roadie publishes across the network.

Roadie MCP Servers
Roadie Catalog API
Roadie Entity Push API
Roadie Scaffolder API
Roadie Tech Insights API