Application API

Topolo Roadmapper

Clear API and contract surface for Topolo Roadmapper, grouped under the application instead of split across generic reference sections.

curated srv_I0z_mOMxdFVa

Documentation Map

Authority

Service IDs:

srv_I0z_mOMxdFVa

Repos: PlatformApplications/TopoloRoadmapper

Hosts:

https://roadmapper.topolo.app https://roadmapper-api.topolo.app

Dependencies: topolo-auth, topolo-nexus, applications-packages

Depends on Topolo Auth: yes

Contract Source

Type: curated

Source: PlatformApplications/TopoloRoadmapper/package.json

Source exists: yes

Current contract coverage is curated rather than OpenAPI-backed, and the browser launcher lane now reads Auth-owned catalog data through same-origin /api/auth/* on the Roadmapper host using the current Auth organization and active context. The browser login handoff, embedded password-login surface, and Auth SSO one-time sso_code callback redemption delegate to the shared Topolo auth client, direct bearer-token callback URLs or /sso?token= bridge routes are not supported, Roadmapper keeps same-tab sessionStorage access-token restore enabled by default after login and refresh so normal reloads do not appear logged out before cookie refresh completes, Roadmapper's vendored @topolo/ui-kit snapshot must stay synchronized with the canonical platform package, the API worker now exposes authenticated `GET /api/widget` for TopoloOne live workspace, and protected API routes now require Topolo Auth validation plus a validated organization context with no Roadmapper-local JWT secret handoff or vendored local HS256 verifier.

API key scopes in Auth catalog: 9

Auth Requirements

No global OpenAPI security scheme is declared.

  • api_keys.write
  • projects.read
  • projects.write
  • reports.read
  • reports.write
  • roadmaps.read
  • roadmaps.write
  • settings.read
  • settings.write

Runtime and Deployment

Wrangler surfaces: PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml, PlatformApplications/TopoloRoadmapper/apps/web/wrangler.toml

Environment variables: ENVIRONMENT, FRONTEND_URL, SERVICE_ID, TOPOLO_AUTH_API_URL, route

Routes: workers.dev or Pages-only delivery

Observability enabled: yes

README-Derived Interface Surface

Source: PlatformApplications/TopoloRoadmapper/README.md

No route-level highlights were extracted from the current README.

Package Surfaces

topolo-roadmapper

Topolo Roadmapper - Project and roadmap management tool

Source: PlatformApplications/TopoloRoadmapper/package.json

Scripts: dev, build, deploy:api, deploy:api:staging, deploy:web, deploy:staging, sync:platform-standardization, sync:platform-standardization:apply

topolo-api

No package description recorded.

Source: PlatformApplications/TopoloRoadmapper/apps/api/package.json

Scripts: dev, deploy, deploy:staging, deploy:dry-run, typecheck, test, build

@roadmapper/web

No package description recorded.

Source: PlatformApplications/TopoloRoadmapper/apps/web/package.json

Scripts: prebuild, build, deploy, dev, preview, clean, typecheck, test

@topolo/domain

No package description recorded.

Source: PlatformApplications/TopoloRoadmapper/packages/domain/package.json

Scripts: build, prepare, dev, clean, test

@topolo/infra

Infrastructure layer for Topolo Roadmapper - Database repositories, external adapters, and Cloudflare bindings

Source: PlatformApplications/TopoloRoadmapper/packages/infra/package.json

Scripts: build, dev, clean, typecheck

Runtime Surface

Wrangler surfaces: PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml, PlatformApplications/TopoloRoadmapper/apps/web/wrangler.toml

This application does not yet have a source-controlled OpenAPI spec in the docs platform. The current API page is derived from the registered contract source and repository surface.