@spec0/sdk-public-platform

TypeScript SDK for Spec0's public API surface — the customer-facing endpoints customers use to publish, list, diff, and search APIs through their CI pipelines and admin tooling.

Generated from the OpenAPI spec at spec0/spec0-platform in Spec0's own public registry.

Install

npm install @spec0/sdk-public-platform

Usage

import { OpenAPI, PublicApisService } from "@spec0/sdk-public-platform";

OpenAPI.BASE = "https://app.spec0.io";
OpenAPI.TOKEN = process.env.SPEC0_TOKEN; // PAT or SAT

const apis = await PublicApisService.listPublicApis();
console.log(apis);

Auth

All endpoints expect a Bearer token. Two flavours work the same way:

• Personal Access Token (pat_...) — minted in the Spec0 dashboard under your profile.
• Service Account Token (sat_...) — minted under team settings, designed for CI.

Each token carries scopes (e.g., read:apis, write:specs). Calls without the required scope return 403 with a missing_scope body.

Versioning

The SDK version mirrors the spec it was generated from. 1.x.y is built from the 1.x.y spec published at spec0/spec0-platform. Bumping a major in the spec ships a new major SDK.

Source

Generated from the spec at:

• Source repo: https://github.com/spec-0/spec0-platform
• Spec path: apps/platform-backend-service/openapi-spec/platform-backend/public-api-v1-spec.yaml

Regeneration on each backend release is wired in .github/workflows/publish-spec0-sdks.yml.