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

WSO2 Comments API

The Comments API from WSO2 — 6 operation(s) for comments.

WSO2 Comments API is one of 90 APIs that WSO2 publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Comments. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 12 operations across 6 paths, and defines 8 schemas. It is described by OpenAPI 3.0.1, at version v4.

Requests are made against a single base URL, https://apis.wso2.com/api/am/admin/v4.

12 operations 6 paths 8 schemas 2 DELETE6 GET2 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
v4
Base URL
https://apis.wso2.com
Authentication
OAuth 2.0
Contact
License
Resource Areas
1

Authentication & Security 1

WSO2 Comments API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2Security) using the password flow, exposing 41 scopes.

Paths & Operations 12

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

Comments 12
GET
/apis/{apiId}/comments
Retrieve API Comments
getAllCommentsOfAPI 5 params → 200404500
POST
/apis/{apiId}/comments
Add an API Comment
addCommentToAPI 2 params body → 201400401404415500
GET
/apis/{apiId}/comments/{commentId}
Get Details of an API Comment
getCommentOfAPI 7 params → 200401404406500
PATCH
/apis/{apiId}/comments/{commentId}
Edit a comment
editCommentOfAPI 2 params body → 200400401403404415500
DELETE
/apis/{apiId}/comments/{commentId}
Delete an API Comment
deleteComment 3 params → 200401403404405500
GET
/apis/{apiId}/comments/{commentId}/replies
Get replies of a comment
getRepliesOfComment 7 params → 200401404406500
GET
/mcp-servers/{mcpServerId}/comments
Retrieve MCP Server Comments
getAllCommentsOfMCPServer 5 params → 200404500
POST
/mcp-servers/{mcpServerId}/comments
Add a MCP Server Comment
addCommentToMCPServer 2 params body → 201400401404415500
GET
/mcp-servers/{mcpServerId}/comments/{commentId}
Get Details of a MCP Server Comment
getCommentOfMCPServer 7 params → 200401404406500
PATCH
/mcp-servers/{mcpServerId}/comments/{commentId}
Edit a comment
editCommentOfMCPServer 2 params body → 200400401403404415500
DELETE
/mcp-servers/{mcpServerId}/comments/{commentId}
Delete a MCP Server Comment
deleteCommentOfMCPServer 3 params → 200401403404405500
GET
/mcp-servers/{mcpServerId}/comments/{commentId}/replies
Get replies of a comment
getRepliesOfCommentOfMCPServer 7 params → 200401404406500

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are Comment (10 properties), Error (5 properties), Pagination (5 properties), CommentList (3 properties). Each schema is shown below with its type and property counts.

CommentList
object
3 properties
ErrorListItem
object
2 properties 2 required
Error
object
5 properties 2 required
Pagination
object
5 properties
CommenterInfo
object
3 properties
Comment
object
10 properties 1 required
PatchRequestBody
object
2 properties
PostRequestBody
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wso2-comments-api-openapi.yml Raw ↑

Other APIs WSO2 publishes across the network.

WSO2 Advanced Policy (Collection) API
WSO2 Advanced Policy (Individual) API
WSO2 AIServiceProvider API
WSO2 AIServiceProviders API
WSO2 Alert Subscriptions API
WSO2 Alerts API
WSO2 Api Artifact API
WSO2 API Categories API
WSO2 API Category (Collection) API
WSO2 API Category (Individual) API
WSO2 API Chat API
WSO2 API Documents API