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

The Surfaces API from Accept — 4 operation(s) for surfaces.

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

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

4 operations 4 paths 6 schemas 4 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 Surfaces 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 4

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

Surfaces 4
GET
/v1/surfaces/{id}
Get a decision surface
getSurface 1 param → 200401403404
GET
/v1/surfaces/{id}/versions
List all versions of a decision surface
listSurfaceVersions 1 param → 200401403404
GET
/v1/surfaces/{id}/impact
Get the dependency graph for a decision surface
getSurfaceImpact 1 param → 200401403404
GET
/v1/surfaces/{id}/recovery
Get recovery analysis for a decision surface
getSurfaceRecovery 1 param → 200401403404

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are Surface (12 properties), SurfaceRecovery (10 properties), SurfaceVersionItem (7 properties), SurfaceImpact (6 properties). Each schema is shown below with its type and property counts.

SurfaceVersionItem
object
A single entry in the surface version history list.
7 properties
SurfaceRecovery
object
Read-only recovery analysis for a decision surface.
10 properties
Error
object
1 property 1 required
SurfaceImpact
object
Full dependency graph for a decision surface — all linked profiles, grants, and distinct agents. All array sections are always present (never null). Warnings a…
6 properties
Surface
object
12 properties
LifecycleStatus
string
Canonical lifecycle posture for versioned governance resources (Surface, Profile, FailModePolicy, EscalationTarget). Every governed configuration entity in MID…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

accept-surfaces-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