Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Accept Controlplane API

The Controlplane API from Accept — 18 operation(s) for controlplane.

Accept Controlplane API is one of 23 APIs that Accept publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Controlplane. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and an AsyncAPI specification.

This API exposes 18 operations across 18 paths, and defines 25 schemas. It is described by OpenAPI 3.1.0, at version 1.1.0-rc.1.

Requests are made against a single base URL, http://localhost:8080.

18 operations 18 paths 25 schemas 1 GET17 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.1.0-rc.1
Base URL
https://midas.accept.io
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Accept Controlplane API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Static bearer token. Configured via MIDASAUTHTOKENS or midas.yaml auth.tokens. Not required when auth.mode=open (development only).

Paths & Operations 18

Across 18 paths, the API surfaces 18 operations — 1 GET, 17 POST. Each is listed below with its method, path, parameters, and response codes.

Controlplane 18
POST
/v1/controlplane/apply
Apply a control-plane configuration bundle
applyBundle body → 200400401403
POST
/v1/controlplane/plan
Preview a control-plane bundle without applying it
planBundle body → 200400401403
GET
/v1/controlplane/audit
List control-plane audit events
listControlAudit → 200401403
POST
/v1/controlplane/surfaces/{id}/approve
Approve a surface in review state
approveSurface 1 param body → 200400401403404409
POST
/v1/controlplane/surfaces/{id}/deprecate
Deprecate an active surface
deprecateSurface 1 param body → 200400401403404
POST
/v1/controlplane/profiles/{id}/approve
Approve a profile version in review state
approveProfile 1 param body → 200400401403404
POST
/v1/controlplane/expectations/{id}/approve
Approve a GovernanceExpectation version in review state
approveGovernanceExpectation 1 param body → 200400401403404409
POST
/v1/controlplane/profiles/{id}/deprecate
Deprecate a profile version
deprecateProfile 1 param body → 200400401403404
POST
/v1/controlplane/fail_mode_policies/{id}/approve
Approve a FailModePolicy version in review state
approveFailModePolicy 1 param body → 200400401403404409
POST
/v1/controlplane/fail_mode_policies/{id}/deprecate
Deprecate an active FailModePolicy version
deprecateFailModePolicy 1 param body → 200400401403404409
POST
/v1/controlplane/drift_definitions/{id}/submit
Submit a DriftDefinition revision for review
submitDriftDefinition 1 param body → 200400401403404409501
POST
/v1/controlplane/drift_definitions/{id}/approve
Approve a DriftDefinition revision in review state
approveDriftDefinition 1 param body → 200400401403404409501
POST
/v1/controlplane/drift_definitions/{id}/reject
Reject a DriftDefinition revision back to draft
rejectDriftDefinition 1 param body → 200400401403404409501
POST
/v1/controlplane/drift_definitions/{id}/deprecate
Deprecate an active DriftDefinition revision
deprecateDriftDefinition 1 param body → 200400401403404409501
POST
/v1/controlplane/drift_definitions/{id}/retire
Retire a DriftDefinition revision
retireDriftDefinition 1 param body → 200400401403404409501
POST
/v1/controlplane/grants/{id}/suspend
Suspend an active grant
suspendGrant 1 param body → 200400401403404
POST
/v1/controlplane/grants/{id}/revoke
Revoke a grant permanently
revokeGrant 1 param body → 200400401403404
POST
/v1/controlplane/grants/{id}/reinstate
Reinstate a suspended grant
reinstateGrant 1 param body → 200400401403404

Schemas 25

The contract defines 25 schemas that model the data the API accepts and returns. The most detailed are DriftDefinition (22 properties), DriftMetricDefinition (12 properties), DeprecateDriftDefinitionRequest (5 properties), GrantLifecycleResponse (3 properties). Each schema is shown below with its type and property counts.

DriftThresholdDirection
string
ApproveSurfaceRequest
object
3 properties 1 required
DriftBaselineStrategy
string
V1 baseline strategies. championchallenger and seasonalityaware are deferred to V2 and MUST NOT appear here.
DriftOrigin
string
ApproveProfileRequest
object
2 properties 2 required
RetireDriftDefinitionRequest
object
DriftDefinition retirement request. Allowed source states: draft, review, active, deprecated. Retired is terminal.
3 properties 1 required
DriftCadence
string
DeprecateProfileRequest
object
2 properties 2 required
RejectDriftDefinitionRequest
object
3 properties 1 required
ApproveGovernanceExpectationRequest
object
2 properties 2 required
LifecycleStatus
string
Canonical lifecycle posture for versioned governance resources (Surface, Profile, FailModePolicy, EscalationTarget). Every governed configuration entity in MID…
ApproveDriftDefinitionRequest
object
2 properties 1 required
DriftMetricDefinition
object
Embedded metric inside a DriftDefinition revision.
12 properties 8 required
DeprecateSurfaceRequest
object
3 properties 2 required
DriftDefinition
object
Governed, versioned drift specification. Composite (id, version) identity. Apply persists Status='review'; activation lives in a future approval-endpoint tranc…
22 properties 13 required
ApproveFailModePolicyRequest
object
2 properties 2 required
DriftTargetRef
object
Discriminated reference to a governed entity.
2 properties 2 required
SubmitDriftDefinitionRequest
object
3 properties 1 required
DriftDefinitionStatus
Lifecycle state of a DriftDefinition. Delegates to the canonical LifecycleStatus posture.
DeprecateFailModePolicyRequest
object
FailModePolicy has no DeprecationReason field on the persisted row; the operator-supplied reason is captured in the control-audit record only.
3 properties 2 required
DriftType
string
V1 drift taxonomy. Population, data, prediction, performance, and concept drift are deferred to V2 and MUST NOT appear here.
Error
object
1 property 1 required
GrantLifecycleResponse
object
3 properties 3 required
DriftTargetEntityKind
string
The nine governed entity kinds a DriftDefinition may target.
DeprecateDriftDefinitionRequest
object
DriftDefinition deprecation request. Successor information is optional; when supplied it is persisted on the row's successordefinitionid and successorversion f…
5 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

accept-controlplane-api-openapi.yml Raw ↑

Other APIs Accept publishes across the network.

Accept Agents API
Accept Aisystems API
Accept Businessservices API
Accept Capabilities API
Accept Coverage API
Accept Decisions API
Accept Drift API
Accept Envelopes API
Accept Escalation Targets API
Accept Escalations API
Accept Evaluate API
Accept Evidence API