[Developers]

Developer Platform Domain

A specialist team needs to add a custom analytical model to the platform, one trained on their specific threat domain. They also need a new dashboard widget to display its outputs. Without a governed extension framework,

Category: Api DomainsLast Updated: Mar 25, 2026
api-domainsai

Overview#

A specialist team needs to add a custom analytical model to the platform, one trained on their specific threat domain. They also need a new dashboard widget to display its outputs. Without a governed extension framework, those additions would require direct platform access, create untested dependencies, and bypass the release controls that keep production stable. The Developer Platform domain provides the controlled environment where that kind of extension work happens safely: model registry, widget runtime, developer console, and automation management, all inside a platform governance boundary.

The domain spans more than model registry and widget publishing. It includes every developer-facing control surface used to manage advanced platform behaviour.

Key Features#

  • Model and Tool Registry: Manage approved analytical models, automation tools, and extension capabilities with version awareness.
  • Widget and Extension Runtime: Support governed runtime execution for reusable dashboard elements and platform extensions.
  • Developer Console Services: Expose controlled diagnostics, testing, and operational tooling for advanced platform work.
  • Agent and Automation Management: Supervise operator-assistance and automation capabilities as managed platform services.
  • Ontology and Structure Support: Connect extension work with governed platform-object models and shared platform structures.
  • Compatibility and Contract Controls: Keep extensions aligned with supported integration and runtime contracts.
  • Developer Enablement: Provide a disciplined foundation for building platform features without bypassing governance or production controls.

Use Cases#

Platform extension teams build and manage approved extensions, widgets, and automation tools within the governed runtime, with compatibility controls ensuring that extensions do not create uncontrolled drift across environments.

Developer operations teams use governed developer-facing tooling for diagnostics, testing, and controlled runtime inspection, accessing the information they need without requiring direct production access.

Automation service delivery teams treat operator-assistance and agent services as managed platform capabilities, deploying them through the same governance controls as any other platform feature.

Architecture teams introduce new extension behaviour safely, with contract controls ensuring that changes to extension interfaces are validated before they affect dependent components.

Integration#

  • Platform Control Plane and release-governance services.
  • Widget-management, runtime, and compatibility systems.
  • Model-management and automation-service workflows.
  • External contract and developer-enablement surfaces.

Open Standards#

  • GraphQL (June 2018 specification): The entire developer-facing API surface, including the integration hub, AI app store, widget capabilities, and approval workflows, is exposed as a typed GraphQL schema with queries and mutations.
  • JSON Web Token (RFC 7519) with RS256 signing: Short-lived playground tokens and service authentication tokens are issued as JWTs, mandatorily signed with RSA-256; HS256 fallback is explicitly removed in production.
  • OAuth 2.0 Bearer Token Usage (RFC 6750): Outbound calls to AI provider endpoints (Cloudflare Workers AI, OpenAI, Anthropic) carry Authorization: Bearer credentials, following the OAuth 2.0 bearer token scheme.
  • Semantic Versioning 2.0.0 (SemVer): Widget and model version identifiers are validated against the MAJOR.MINOR.PATCH SemVer format; version constraints on widget dependencies also follow this scheme.
  • JSON (RFC 8259 / ECMA-404): All API payloads, widget manifests, sandbox configurations, scan findings, and prompt template variables are exchanged as JSON; the GraphQL schema exposes a dedicated JSON scalar for untyped structures.
  • ISO 8601 / RFC 3339 date-time format: All timestamp fields across the model registry, widget lifecycle events, approval workflows, and usage statistics are serialised in ISO 8601 extended format.
  • UUID (RFC 4122): Every entity, including models, widgets, tenants, users, and versions, is identified by a UUID v4, used consistently across database keys and API identifiers.
  • Role-Based Access Control (NIST RBAC model, ANSI/INCITS 359-2004): Access to model registration, widget publishing, BYOM governance, and developer console operations is governed by named roles (admin, tenant_admin, user, read_only) enforced at the service layer.

Last Reviewed: 2026-03-25 Last Updated: 2026-04-14

Ready to Build?

Get started with our APIs or contact our integration team for support.