APIs.io Engineering Platform Comments API
The **Comments** endpoints enable you to manage comments on an API element. You can use [comments](https://learning.postman.com/docs/collaborating-in-postman/working-with-your-team/discussing-your-work/) to collaborate and discuss your work with your teammates in Postman.
This API exposes 21 operations across 11 paths, and defines 6 schemas. It is described by OpenAPI 3.0.0, at version 2015-07-09.
Requests are made against 4 base URLs: http://apigateway.{region}.amazonaws.com, https://apigateway.{region}.amazonaws.com, http://apigateway.{region}.amazonaws.com.cn, https://apigateway.{region}.amazonaws.com.cn.
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
APIs.io Engineering Platform Comments API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as Authorization (hmac).
By default, every request must be authenticated.
hmac— Amazon Signature authorization v4
Paths & Operations 21
Across 11 paths, the API surfaces 21 operations — 5 DELETE, 5 GET, 6 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.
The Comments endpoints enable you to manage comments on an API element. You can use [comments](https://learning.postman.com/docs/collaborating-in-postman/working-with-your-team/di…
Schemas 6
The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are featureUnavailable403Error (4 properties), comment403Error (4 properties), v10HeaderMissing (2 properties), commentCreateUpdate (2 properties). Each schema is shown below with its type and property counts.
Specification
The full machine-readable OpenAPI contract behind this narrative.