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 Graphs API

The Graphs API from Accept — 2 operation(s) for graphs.

Accept Graphs 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 Graphs. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and an AsyncAPI specification.

This API exposes 2 operations across 2 paths, and defines 48 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.

2 operations 2 paths 48 schemas 2 GET

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 Graphs 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 2

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

Graphs 2
GET
/v1/graphs/context
Project a depth-bounded Context Graph rooted at an entity
getContextGraph 3 params → 200400401403404405501
GET
/v1/graphs/authority
Project a depth-bounded Authority Graph rooted at a business service
getAuthorityGraph 3 params → 200400401403404405501

Schemas 48

The contract defines 48 schemas that model the data the API accepts and returns. The most detailed are AuthorityGraphSummary (21 properties), AuthorityGraphAuthorityProfileData (16 properties), AuthorityGraphEscalationTargetData (13 properties), ContextGraphNode (12 properties). Each schema is shown below with its type and property counts.

AuthorityGraphSeverityRollupValue
string
Severity-rollup vocabulary used by DiagnosticSummary.highestseverity and SurfaceAuthorityPosture.highestseverity. The three non-"none" values share string iden…
ContextGraphCapabilityData
object
Typed data for a node of kind capability.
7 properties 3 required
AuthorityGraphDiagnostic
object
One operator-actionable condition observed during projection. noderefs identifies the entities the diagnostic applies to (most-specific entity first, supportin…
4 properties 2 required
ContextGraphExternalRefData
object
External reference structure mirroring the governance-map externalref wire shape (httpapi.externalRefResponse). Same field names and JSON tags so consumers can…
5 properties 2 required
ContextGraphAuthoritySummaryData
object
Typed data for the synthetic authoritysummary node. Mirrors the governance-map AuthoritySummary DTO field-for-field so the values are directly comparable acros…
4 properties 4 required
AuthorityGraphFailModePolicyStatus
string
Surface-level fail-mode posture. "override" — surface's own FailModePolicyID resolved. "inherited" — BS default supplies the effective policy. "missing" — no e…
AuthorityGraphValidityStatus
string
Time-window classification an authority profile or grant carries on its typed data. Emitted nodes always carry "effective"; future-dated and expired entities a…
AuthorityGraphConsequenceThreshold
object
Typed value object representing an authority profile's consequence threshold. Exactly one variant is populated based on type — monetary (amount + currency) or…
4 properties 1 required
AuthorityGraphSurfaceAuthorityPosture
object
Per-surface authority posture (D31m). One record per emitted active decision surface in the FULL pre-depth-filter projection. Frontends consume this to render…
11 properties 10 required
AuthorityGraphNodeRef
object
Reference to a node by its (kind, id) pair. Used by edge endpoints and the projection root.
2 properties 2 required
AuthorityGraphFailModePolicyData
object
Typed data for a failmodepolicy node. Carries identity, lifecycle, and ownership; the full Rules array is omitted (operator-noisy) but the per-class rule count…
11 properties 5 required
AuthorityConstraint
object
One typed runtime constraint attached to an AuthorityGrant. The orchestrator evaluates each constraint on every request; the first violation rejects with reaso…
5 properties 1 required
AuthorityGraphEffectivePolicySource
string
Resolved fail-mode-policy origin per decision surface. "override" — the surface had a non-empty FailModePolicyID that resolved to an active version. "businesss…
ContextGraphCoverageData
object
Typed data for the synthetic coverage node. Mirrors the governance-map Coverage DTO (Phase 9 explicit field naming); the three AI-binding counters are mutually…
4 properties 4 required
AuthorityGraphDiagnosticSeverity
string
Operator-facing severity for diagnostics.
AuthorityConstraintKind
string
Discriminator for the AuthorityConstraint value object. Each kind populates exactly the fields relevant to its variant: - confidencethresholdmin: uses minconfi…
ContextGraphAISystemBindingData
object
Typed data for a node of kind aisystembinding. The four scope-id pointers mirror the governance-map binding DTO; scopekind / scopeid / scopelabel record the mo…
12 properties 9 required
ContextGraphDecisionSurfaceData
object
Typed data for a node of kind decisionsurface. The two binding-id arrays are non-nil (possibly empty) and disjoint per the governance-map contract.
12 properties 10 required
AuthorityGraphDiagnosticSummary
object
Per-severity rollup over the full pre-depth diagnostics array (D31m). Counts sum to len(diagnostics). highestseverity is "none" when the array is empty, otherw…
5 properties 4 required
ContextGraphRelatedBusinessServiceRow
object
Per-direction relationship row data carried on a relatedbusinessservice node. Mirrors the governance-map relationship DTO's per-row fields for the fields avail…
3 properties 2 required
AuthorityGraphDiagnosticKind
string
Operator-facing diagnostic vocabulary.
ContextGraphBusinessServiceData
object
Typed data for a node of kind businessservice. Mirrors the governance-map businessService DTO for the fields available on the businessservice.BusinessService d…
9 properties 3 required
AuthorityGraphBusinessServiceData
object
Typed data for a businessservice node.
7 properties 3 required
ContextGraphEdge
object
One directed link in the projection. Direction is encoded as (src → dst) per the kind contract documented on /v1/graphs/context.
4 properties 3 required
ContextGraphNode
object
One projected entity. Phase 1 fields (kind, id, label) are always populated. Phase 2A adds typed per-kind data pointers — exactly one is populated per node and…
12 properties 3 required
AuthorityGraphRuleCountByClass
object
Per-correctness-class rule count summary for a FailModePolicy. All five CorrectnessClass values are present, defaulting to zero. Provides at-a-glance coverage…
5 properties 5 required
ContextGraphRelatedBusinessServiceData
object
Typed data for a node of kind relatedbusinessservice. One node is emitted per related-BS id, even when the same other-BS appears in both outgoing and incoming…
4 properties 1 required
AuthorityGraphEscalationStatus
string
Surface-level escalation routing posture. "targeted" — at least one effective profile under the surface references an active EscalationTarget. "nottargeted" —…
AuthorityGraphGrantStatus
string
Surface-level grant coverage. "covered" when at least one effective profile under the surface has at least one effective grant; "missing" otherwise.
AuthorityGraphExternalRefData
object
Optional external reference for a business service node. Mirrors the externalref domain type. Field set matches ContextGraphExternalRefData but is kept as a si…
5 properties
AuthorityCapability
string
One of the five canonical capabilities an AuthorityGrant may authorise. The set is fixed; new capability values require a domain change. Stop is intentionally…
AuthorityGraphSummary
object
Backend-computed posture rollup for a service-view Authority Graph projection. Count fields are always present; per-entity gap lists use omitempty. Summary des…
21 properties 13 required
AuthorityGraphNode
object
One entity in the projected Authority Graph. Exactly one typed-data slot is populated per node, matched to kind. Unused slots are omitted from the wire payload…
10 properties 3 required
AuthorityGraphAgentData
object
Typed data for an agent node. Agent.Endpoint is intentionally not exposed via the graph — it is an internal URL not appropriate for a read-only projection.
6 properties 4 required
AuthorityGraphAgentStatus
string
Surface-level agent coverage. Precedence: blocked missing covered. "blocked" when any grant under the surface fires a critical missing/inactive-agent diagnosti…
AuthorityGraphDecisionSurfaceData
object
Typed data for a decisionsurface node. D31g adds resolved fail-mode-policy metadata (effectivepolicysource, effectivepolicyid, effectivepolicyversion, inherits…
11 properties 4 required
AuthorityGraphAuthorityStatus
string
Surface-level authority posture roll-up. Precedence (worst → best): uncovered incomplete degraded complete. Info-only diagnostics do NOT degrade a complete sur…
AuthorityGraphEdge
object
One directed link in the Authority Graph. Direction is encoded as (src → dst) per the kind contract documented on /v1/graphs/authority. The fail-mode-policy ed…
4 properties 3 required
ContextGraphNodeRef
object
(kind, id) pair uniquely identifying a node within a single projection.
2 properties 2 required
Error
object
1 property 1 required
AuthorityGraphAuthorityProfileData
object
Typed data for an authorityprofile node. Includes lifecycle fields (status, effectivedate, approvedby/at) plus the runtime-relevant configuration (thresholds,…
16 properties 6 required
ContextGraphAISystemData
object
Typed data for a node of kind aisystem. activeversion, activeversionlabel, and activeversionstatus are populated when the AI system has an active version on th…
10 properties 3 required
ContextGraphProcessData
object
Typed data for a node of kind process. The process domain type does not currently carry an externalref field, so this struct has no externalref attribute. If t…
6 properties 4 required
ContextGraphProjection
object
Top-level response shape for GET /v1/graphs/context. Nodes are sorted by (kind, id) ascending; edges are sorted by (kind, src.kind, src.id, dst.kind, dst.id) a…
5 properties 5 required
AuthorityGraphProjection
object
Top-level response shape for GET /v1/graphs/authority. Nodes are sorted by (kind, id) ascending; edges are sorted by (kind, src.kind, src.id, dst.kind, dst.id)…
9 properties 5 required
AuthorityGraphAuthorityGrantData
object
Typed data for an authoritygrant node. Grant references the profile by logical id (not by version). Noisy lifecycle fields (suspend/revoke metadata, GrantReaso…
10 properties 4 required
AuthorityGraphEscalationTargetData
object
Typed data for an escalationtarget node (D31l). Mirrors the escalation.EscalationTarget domain fields the graph projects as a read model. The escalation contex…
13 properties 6 required
AuthorityGraphProfileStatus
string
Surface-level profile coverage. "covered" when at least one effective profile attaches to the surface; "missing" otherwise.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

accept-graphs-api-openapi.yml Raw ↑

Other APIs Accept publishes across the network.

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