ShipLog API

Public discovery and changelog endpoints

These endpoints power ShipLog's public changelog pages, sitemap, API catalog, and agent discovery surfaces.

Base URLs

Site: https://shiplog.today

API: https://shiplog-production.up.railway.app

API catalog: /.well-known/api-catalog

OpenAPI: /openapi.json

OAuth metadata: /.well-known/oauth-authorization-server

Protected resource metadata: /.well-known/oauth-protected-resource

Endpoints

GET/api/public/catalog

List published public changelog slugs and their latest publish time.

GET/api/public/{slug}

Fetch public repo metadata for a ShipLog changelog.

GET/api/public/{slug}/entries?limit=20

Fetch recent published changelog entries.

GET/api/public/{slug}/releases

Fetch published releases with grouped entries.

POST/api/public/{slug}/subscribe

Subscribe an email address to public changelog updates.

GET/health

Backend health endpoint exposed by the API service.

OAuth for agents

ShipLog exposes an OAuth 2.0 authorization code flow with PKCE for agents that need to access protected user API routes.

Authorization endpoint: https://shiplog-production.up.railway.app/api/oauth/authorize

Token endpoint: https://shiplog-production.up.railway.app/api/oauth/token

Supported scope: shiplog