Developer Portal API
The Developer Portal (GET /devdocs) is the interactive API reference for your deployed Control Plane.
It provides endpoint documentation, authentication guides, and integrated code examples for every
Control Core API surface — from policy lifecycle to OEM embedded deployments.
Access it at:
https://<your-control-plane-url>/devdocs
What's in the Developer Portal
| Section | What it covers |
|---|---|
| Getting Started | Authentication (POST /auth/token), API keys, OAuth2 |
| Policies & Controls | Full policy lifecycle, policies-as-code CI flow, impact simulation |
| Resources & Bouncers | Protected resource catalog, Bouncer (PEP) registration and fleet management |
| Policy Data & Integrations | PIP data sources, context rules, MCP server connections |
| AI Gateway & MCP | AI agent governance, SCCA (Rego from natural language), AI Pilot templates |
| Audit & Observability | Enforcement decision logs, SIEM export, signed webhooks, retention |
| OEM & Embedded | Headless deployment API (/api/v2/oem/*), zero-touch Bouncer provisioning |
| Developer Tools | Approval workflows, in-browser Rego editor (Monaco), IDE backends |
| Reference & Admin | Health probes, dashboard stats, settings, license management |
Languages
The Developer Portal is available in English, Spanish, and French.
Switch languages using the selector in the top-right corner or via the ?lang= query parameter:
https://<your-control-plane-url>/devdocs?lang=es # Spanish
https://<your-control-plane-url>/devdocs?lang=fr # French
Language preference persists in localStorage across sessions.
Technical terms (policy engine, Policy Bridge, Rego, PBAC, PEP, JWT, MCP) remain in English across all locales.
OpenAPI spec
The machine-readable OpenAPI specification is available at:
| URL | Use |
|---|---|
/openapi.json | Latest spec (English) — SDK generation, CI contract checks |
/docs-assets/openapi/en.json | English locale spec |
/docs-assets/openapi/es.json | Spanish locale spec |
/docs-assets/openapi/fr.json | French locale spec |
Generate a typed client:
openapi-generator-cli generate \
-i https://<your-control-plane-url>/openapi.json \
-g python -o ./cc-sdk
OEM Integration Guide
For headless and embedded deployments, the OEM Integration Guide covers the
complete generate → validate → test → deploy API flow with code examples in
curl, Python, Node.js, and Go:
https://<your-control-plane-url>/devdocs/guides/oem-integration
Topics covered: zero-touch Bouncer provisioning, multi-tenant workspace_id scoping,
TTL-gated controls, authentication for automated pipelines, and troubleshooting.
Related guides
- Authentication guide — base URLs, curl patterns, auth steps
- OEM embedding guide — full headless deployment reference
- Policies-as-code API — CI-friendly policy lifecycle
- IDE Integration API — editor and IDE backend endpoints
- Audit API integration — SIEM, webhooks, export