WSO2 · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for WSO2 API Manager - Developer Portal Ratings API

9 actions 9 updates phrasing extends openapi/wso2-ratings-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for WSO2's API. It is a proposal applied on top of the contract, not a document WSO2 publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 9

$.info
$.paths['/apis/{apiId}/ratings'].get
$.paths['/apis/{apiId}/user-rating'].get
$.paths['/apis/{apiId}/user-rating'].put
$.paths['/apis/{apiId}/user-rating'].delete
$.paths['/mcp-servers/{mcpServerId}/ratings'].get
$.paths['/mcp-servers/{mcpServerId}/user-rating'].get
$.paths['/mcp-servers/{mcpServerId}/user-rating'].put
$.paths['/mcp-servers/{mcpServerId}/user-rating'].delete

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WSO2 API Manager - Developer Portal Ratings API
  version: 1.0.0
extends: openapi/wso2-ratings-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/apis/{apiId}/ratings'].get
  update:
    x-apievangelist-phrasing:
      intent: List all ratings of an API
      effect: read
      questions:
      - What ratings have developers given an API in the portal?
      - Can I page through every rating left on an API?
      instructions:
      - text: List all ratings for API {apiId}.
        slots:
          apiId: path.apiId
      - text: Show the first {limit} ratings of API {apiId}.
        slots:
          limit: query.limit
          apiId: path.apiId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/apis/{apiId}/user-rating'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my own rating of an API
      effect: read
      questions:
      - What rating did I personally give this API?
      - Can I see the score I left on an API as the logged-in user?
      instructions:
      - text: Show my rating for API {apiId}.
        slots:
          apiId: path.apiId
      - text: Get the score I gave API {apiId}.
        slots:
          apiId: path.apiId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/apis/{apiId}/user-rating'].put
  update:
    x-apievangelist-phrasing:
      intent: Rate an API or change my rating
      effect: write
      questions:
      - Can I give an API a star rating or change the one I gave?
      - How do I rate an API in the developer portal?
      instructions:
      - text: Rate API {apiId} with {rating} stars.
        slots:
          apiId: path.apiId
          rating: requestBody.rating
      - text: Change my rating of API {apiId} to {rating}.
        slots:
          apiId: path.apiId
          rating: requestBody.rating
      method: generated
      generated: '2026-10-01'
- target: $.paths['/apis/{apiId}/user-rating'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove my rating from an API
      effect: destructive
      questions:
      - Can I take back the rating I left on an API?
      - Is it possible to delete my own API rating?
      instructions:
      - text: Delete my rating on API {apiId}.
        slots:
          apiId: path.apiId
      - text: Withdraw the score I gave API {apiId}.
        slots:
          apiId: path.apiId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mcp-servers/{mcpServerId}/ratings'].get
  update:
    x-apievangelist-phrasing:
      intent: List ratings of an MCP server
      effect: read
      questions:
      - What ratings have users given an MCP server?
      - Can I page through all the ratings on an MCP server?
      instructions:
      - text: List all ratings for MCP server {mcpServerId}.
        slots:
          mcpServerId: path.mcpServerId
      - text: Show {limit} ratings of MCP server {mcpServerId}.
        slots:
          limit: query.limit
          mcpServerId: path.mcpServerId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mcp-servers/{mcpServerId}/user-rating'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my rating of an MCP server
      effect: read
      questions:
      - What rating did I give this MCP server?
      - Can I check my own rating of an MCP server in another tenant?
      instructions:
      - text: Show my rating for MCP server {mcpServerId}.
        slots:
          mcpServerId: path.mcpServerId
      - text: Get my rating of MCP server {mcpServerId} in tenant {tenant}.
        slots:
          mcpServerId: path.mcpServerId
          tenant: header.X-WSO2-Tenant
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mcp-servers/{mcpServerId}/user-rating'].put
  update:
    x-apievangelist-phrasing:
      intent: Rate an MCP server
      effect: write
      questions:
      - How do I give an MCP server a star rating?
      - Can I change the rating I previously gave an MCP server?
      instructions:
      - text: Rate MCP server {mcpServerId} {rating} stars.
        slots:
          mcpServerId: path.mcpServerId
          rating: requestBody.rating
      - text: Change my rating of MCP server {mcpServerId} to {rating}.
        slots:
          mcpServerId: path.mcpServerId
          rating: requestBody.rating
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mcp-servers/{mcpServerId}/user-rating'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove my rating of an MCP server
      effect: destructive
      questions:
      - How do I withdraw the rating I gave an MCP server?
      - Can I delete my MCP server rating entirely?
      instructions:
      - text: Delete my rating for MCP server {mcpServerId}.
        slots:
          mcpServerId: path.mcpServerId
      - text: Remove the rating I gave MCP server {mcpServerId}.
        slots:
          mcpServerId: path.mcpServerId
      method: generated
      generated: '2026-10-01'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay 
curl "https://apis.io/api/v1/overlays/wso2-ratings-api-phrasing-overlay"
All openapi overlays 
curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.