API Domain Ownership Matrix

This document is the maintainer-facing ownership matrix for app API domains. The generated router inventory lists every router; this file explains who owns each domain and what docs must change with it.

Generated inventory:

• docs/generated/api-router-inventory.md

Domain Matrix

| Domain | Primary routers | Owner | Required docs when changed | |---|---|---|---| | Workers and workforce | workers, cohorts, workforce, workforce-plans, hris, job-architecture, scale, launch-readiness, hiring-requests, lifecycle, incidents | App product/runtime | docs/API_SURFACE.md, frontend/docs/DASHBOARD_SURFACE.md, generated API inventory | | Objectives and execution | objectives, tasks, flows, metrics, ops, deployment-runs, sandbox, source-control-plane | App product/runtime | docs/API_SURFACE.md, docs/OPERATIONS_SURFACE.md, generated API inventory | | Governance and controls | policies, approvals, execution-posture, drift, audit, compliance, data-lifecycle | Governance/runtime | docs/API_SURFACE.md, docs/security/, generated API inventory | | Identity and access | sso, saml, scim, api-keys, mcp-tokens, members, credentials, vault, secrets | Platform/security | docs/API_KEYS.md, docs/api/, docs/OPERATIONS_SURFACE.md, generated API inventory | | Connectors and integrations | connectors, registry, tools, siem, webhooks, integrations, llm | Connector/runtime | docs/CONNECTOR_SURFACE.md, docs/integration-guides/, generated connector inventory | | Catalog and marketplace | role-library, platform-apps, deployments, public-proposals, manifest-review, healthcare-apps, lowcode, matrix-sync | App catalog/runtime | frontend/docs/DASHBOARD_SURFACE.md, docs/API_SURFACE.md, generated dashboard/API inventories | | Atlas and consultants | atlas, atlas-consultant, consultants, exec-dashboards | Atlas/consulting workflows | docs/API_SURFACE.md, dashboard inventory | | Notifications and admin | notifications, ip-allowlist, platform-admin, billing, onboarding, assessment, geordie | Platform/admin | docs/OPERATIONS_SURFACE.md, frontend/docs/DASHBOARD_SURFACE.md, generated inventories | | Demo and health | demo, health routes, /metrics | Platform/ops | docs/OPERATIONS_SURFACE.md | | SDK execution | sdk | SDK/runtime | docs/sdk-integration-guide.md, SDK README |

Maintenance Rule

When adding or renaming a router:

1. Regenerate docs/api/openapi-v1.json.
2. Run python3 scripts/generate_docs_inventory.py.
3. Update docs/API_SURFACE.md if the router adds a new product domain.
4. Update this matrix if ownership or required docs change.
5. Update dashboard or operations docs if the API backs a visible/admin workflow.