Outline · Example Payload

Commentscreate

Comments

Commentscreate is an example object payload from Outline, with 6 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

operationIdpathmethodsummarytagsrequestSchema

Example Payload

Raw ↑
{
  "operationId": "commentsCreate",
  "path": "/comments.create",
  "method": "POST",
  "summary": "Create a comment",
  "tags": [
    "Comments"
  ],
  "requestSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "format": "uuid"
      },
      "documentId": {
        "type": "string",
        "format": "uuid"
      },
      "parentCommentId": {
        "type": "string",
        "format": "uuid"
      },
      "data": {
        "type": "object",
        "description": "The body of the comment."
      },
      "text": {
        "type": "string",
        "description": "The body of the comment in markdown.",
        "example": "Sounds great"
      },
      "anchorText": {
        "type": "string",
        "description": "Plain text substring to anchor the comment to as an inline comment. The first occurrence in the document's plain text is used unless disambiguated by `anchorPrefix` and/or `anchorSuffix`."
      },
      "anchorPrefix": {
        "type": "string",
        "description": "Text immediately preceding `anchorText`, used to disambiguate between multiple occurrences. Requires `anchorText`."
      },
      "anchorSuffix": {
        "type": "string",
        "description": "Text immediately following `anchorText`, used to disambiguate between multiple occurrences. Requires `anchorText`."
      }
    },
    "required": [
      "documentId"
    ]
  }
}

Work with this as data

Every example 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 examples

4 MCP tools reach this
  • find_examplesBrowse and filter every example 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 example
curl "https://apis.io/api/v1/examples/commentsCreate"
All examples
curl "https://apis.io/api/v1/examples?limit=25"

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

Get an API key

Free tier, no email required.

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