Social Studio API | Topolo Docs

Documentation Map

Authority

Service IDs:

srv_topolo_social_studio

Repos: PlatformApplications/TopoloSocialStudio

Hosts:

https://studio.topolo.app https://topolo-social-studio.pages.dev

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

Depends on Topolo Auth: yes

Contract Source

Type: curated

Source: PlatformApplications/TopoloSocialStudio/package.json

Source exists: yes

Canonical public and internal docs now cover the hybrid desktop, worker, and Nexus-backed AI generation model. The marketing web and desktop shells delegate browser login handoff and one-time sso_code callback redemption to the shared Topolo auth client through the Social Studio application wrapper, with callback effects kept single-pass so one status update cannot cancel the active exchange/bootstrap. The authenticated web and desktop shells render through `TopoloAppShell`, inheriting the shared account, launcher, Improve Topolo, and TopoloNotify chrome while keeping Studio project navigation product-owned. Nexus owns the org-wide image-generation default and allowed model catalog for Studio workspaces, while the generate step may expose per-run inline overrides only to callers with the required workspace authority. Production Auth must keep the Social Studio manifest permissions, role bundles, API-key scopes, and organization-scoped grants synced so bootstrap receives current service permissions.

API key scopes in Auth catalog: 11

Auth Requirements

No global OpenAPI security scheme is declared.

api_keys.write
approvals.write
assets.read
assets.write
briefs.read
briefs.write
exports.read
generation.write
settings.write
workspace.read
workspace.write

Runtime and Deployment

Wrangler surfaces: PlatformApplications/TopoloSocialStudio/apps/api-worker/wrangler.toml, PlatformApplications/TopoloSocialStudio/apps/marketing-web/wrangler.toml, PlatformApplications/TopoloSocialStudio/apps/queue-worker/wrangler.toml

Environment variables: ADDITIONAL_ALLOWED_ORIGINS, API_WORKER_URL, APP_ENV, AUTH_BASE_URL, BILLING_SUPPORT_CONTACT, DESKTOP_APP_URL, DESKTOP_SYNC_QUEUE, GENERATION_QUEUE_NAME, MARKETING_APP_URL, QUEUE_CONSUMER_NAME, TOPOLO_AUTH_SERVICE_ID, TOPOLO_BUG_REPORTER_URL, TOPOLO_LAUNCHER_URL

Routes: workers.dev or Pages-only delivery

Observability enabled: yes

README-Derived Interface Surface

Source: PlatformApplications/TopoloSocialStudio/README.md

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

Package Surfaces

topolo-social-studio

Hybrid macOS desktop and Cloudflare scaffold for Topolo Social Studio.

Source: PlatformApplications/TopoloSocialStudio/package.json

Scripts: build, ci:launch, dev, dev:api, dev:desktop, desktop:build:local, desktop:build:staging, desktop:build:production, desktop:dev, desktop:manifest, lint, format, format:check, test, test:e2e, test:e2e:desktop

@topolo-social-studio/api-worker

No package description recorded.

Source: PlatformApplications/TopoloSocialStudio/apps/api-worker/package.json

Scripts: build, dev, typecheck, deploy, deploy:staging

@topolo-social-studio/desktop

No package description recorded.

Source: PlatformApplications/TopoloSocialStudio/apps/desktop/package.json

Scripts: build, dev, desktop:build, desktop:build:local, desktop:build:staging, desktop:build:production, desktop:dev, desktop:manifest, typecheck

@topolo-social-studio/marketing-web

No package description recorded.

Source: PlatformApplications/TopoloSocialStudio/apps/marketing-web/package.json

Scripts: build, dev, typecheck

@topolo-social-studio/queue-worker

No package description recorded.

Source: PlatformApplications/TopoloSocialStudio/apps/queue-worker/package.json

Scripts: build, dev, typecheck, deploy, deploy:staging

Runtime 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.