Back to docs

Public surfaces

This page maps the current public Proof of Ship surface into three buckets: live today, repo-shipped contracts, and contract-only endpoints not yet claimed as deployed UI. For GitHub OAuth and repo linking, read contract-only as “stable public docs exist, but no broad hosted settings UI is being claimed here.”

Live

Homepage
/u/<handle>/score.json
/u/<handle>/receipts.json
Badge assets

Repo-shipped

CLI surface
JSON schemas
Example payloads
Badge assets and embeds

Contract-only

GET /auth/github/start
GET /auth/github/callback
GET /api/v1/account
GET /api/v1/account/repositories
POST /api/v1/account/repositories
DELETE /api/v1/account/repositories/{owner}/{repo}

GitHub OAuth proves identity. Repo linking proves an allowed public-repo relationship. Reputation still depends on independent artifact verification.

Read the public contract guide