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

The Capabilities API from Accept — 5 operation(s) for capabilities.

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

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

5 operations 5 paths 8 schemas 5 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 Capabilities 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 5

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

Capabilities 5
GET
/v1/capabilities
List all capabilities
listCapabilities → 200401403
GET
/v1/capabilities/{id}
Get a capability by ID
getCapabilityById 1 param → 200401403404
GET
/v1/capabilities/{id}/children
List direct child capabilities of a parent capability
listCapabilityChildren 1 param → 200401403404501
GET
/v1/capabilities/{id}/businessservices
List Business Services that use a capability
listCapabilityBusinessServices 1 param → 200401403404501
GET
/v1/capabilities/{id}/ai-bindings
List AI System bindings scoped directly to a capability
listCapabilityAIBindings 1 param → 200401403404501

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are Capability (13 properties), AISystemBinding (12 properties), BusinessService (11 properties), ExternalRef (5 properties). Each schema is shown below with its type and property counts.

CapabilityBusinessServicesResponse
object
Envelope for the reverse Capability → BusinessService lookup (GET /v1/capabilities/{id}/businessservices, Phase 3B). Both keys are always present. The business…
2 properties 2 required
Capability
object
A business capability (Phase 1 wire-complete shape). The persisted record holds hierarchy (parentcapabilityid), lifecycle (origin, managed, replaces), audit (c…
13 properties
ExternalRef
object
Structured reference to an entity in an external system (ServiceNow, LeanIX, GitHub, internal catalogues, custom). MIDAS records the reference but never valida…
5 properties 2 required
CapabilityChildrenResponse
object
Envelope for the children read endpoint (GET /v1/capabilities/{id}/children, Phase 3A). Both keys are always present. The capabilities array contains direct ch…
2 properties 2 required
Error
object
1 property 1 required
BusinessService
object
A business service grouping for processes (V2 structural layer). Mirrors the businessServiceResponse wire format.
11 properties
CapabilityAIBindingsResponse
object
Envelope for the Capability-scoped AI bindings endpoint (GET /v1/capabilities/{id}/ai-bindings, Phase 3C). Both keys are always present. The bindings array con…
2 properties 2 required
AISystemBinding
object
Immediate-apply junction linking an AI system (optionally pinned to a specific version) to one or more existing MIDAS context entities (BusinessService, Capabi…
12 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

accept-capabilities-api-openapi.yml Raw ↑

Other APIs Accept publishes across the network.

Accept Agents API
Accept Aisystems API
Accept Businessservices 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
Accept Evidence API