T Topolo Docs

Application API

Bytes

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

curated srv_JUFXzHBX4eWq

Documentation Map

Authority

Service IDs:

srv_JUFXzHBX4eWq

Repos:

Hosts:

https://bytes.topolo.app https://bytes-api.topolo.app https://bytes.stg.topolo.us https://bytes-api.stg.topolo.us

Dependencies: topolo-auth, applications-packages

Depends on Topolo Auth: yes

Contract Source

Type: curated

Source: PlatformApplications/TopoloDocs/src/content/public/applications/bytes.mdx

Source exists: no

Canonical Bytes coverage now lives in the docs application, the browser launcher lane now reads Auth-owned catalog data through same-origin /api/auth/* on the Bytes host, the browser callback delegates one-time `sso_code` exchange to the shared Auth client without exposing a legacy `/sso?token=` route or app-local `/sso/exchange` parser, accepts a compact exchanged-token payload, and SPA-navigates after auth update events so the memory-only token survives protected-route hydration. First-party embedded password login also completes through Bytes-owned router navigation after shared Auth token persistence. Closed lazy panels and modals are deferred until opened so `/browse` startup is not held behind hidden Suspense loaders. The worker now requires Topolo Auth validation for all operator bearer tokens with no Bytes-local JWT secret path. Bytes keeps app identity in the repo-level app-identity module and resolves the concrete Auth service id from the canonical topolo-bytes slug at runtime for browser headers, worker permission checks, API-key management, notification emission, and widget responses. Bytes exposes `GET /api/widget` with the shared `@topolo/sdk` widget response contract for TopoloOne live workspace.

API key scopes in Auth catalog: 12

Auth Requirements

No global OpenAPI security scheme is declared.

  • api_keys.write
  • files.delete
  • files.read
  • files.write
  • folders.read
  • folders.write
  • media.read
  • media.write
  • pipelines.invoke
  • sharing.read
  • sharing.write
  • storage.read

Runtime and Deployment

Wrangler surfaces: none detected

Environment variables: none derived

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit signal found

Runtime Surface

Wrangler surfaces: No wrangler file detected in scanned surface

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.

Failure modes

  • No wrangler.toml surface was discovered under the registered repo paths.
  • The registered contract source is missing: PlatformApplications/TopoloDocs/src/content/public/applications/bytes.mdx
  • Neither OpenAPI nor README-derived interface detail was found.