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

APIIDA Versions API

API version management

APIIDA Versions API is one of 6 APIs that APIIDA publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include Versions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 3 JSON Schemas.

This API exposes 2 operations across 2 paths. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against a single base URL, https://{tenant}.backend.apiida.io.

2 operations 2 paths 0 schemas 1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Base URL
https://api.apiida.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

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

  • bearerAuth — Bearer token authentication

Paths & Operations 2

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

Versions 2

API version management

POST
/apis/{apiId}/versions
APIIDA Create API Version
createApiVersion 1 param body → 201401404
PUT
/apis/{apiId}/versions/{version}/openProxySpec
APIIDA Upload Specification to API Version
uploadOpenProxySpec 2 params body → 200401404

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

apiida-versions-api-openapi.yml Raw ↑

Other APIs APIIDA publishes across the network.

APIIDA Alarms API
APIIDA Apis API
APIIDA Deployments API
APIIDA Gateways API
APIIDA Monitoring API