Cotal Feedback API

The Feedback API from Cotal — 1 operation(s) for feedback.

GitHub OpenAPI

Operations 2

POST /v1/feedback Submit tester feedback #
OPTIONS /v1/feedback CORS preflight #

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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 API
curl "https://apis.io/api/v1/apis/cotal-ai:cotal-ai-feedback-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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

OpenAPI Specification

cotal-ai-feedback-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cotal Ai Feedback API
  x-refined-note:
  - x-deprecation-policy differs across the merged source definitions and was not carried
  - x-mcp differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Feedback across 3 of this provider''s published API definitions: cotal-ai-feedback-intake-openapi.json, cotal-ai-public-api-openapi.json, cotal-ai-feedback-intake-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: http://{host}:{port}
  variables:
    host:
      default: 127.0.0.1
    port:
      default: '8787'
- url: https://cotal.ai
  description: Production. Sandbox mode is the X-Sandbox header, not a separate host.
tags:
- name: Feedback
paths:
  /v1/feedback:
    post:
      operationId: submit-feedback
      summary: Submit tester feedback
      description: Authenticate the tester key, reserve one rate-limit admission, validate and persist the record, then attempt mesh publication. Tester identity comes from the provisioned key record, not the request body. Raw diagnostics are not echoed in the response.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Feedback'
            example:
              origin: human
              type: friction
              summary: The setup command did not explain the missing broker.
              severity: low
      responses:
        '202':
          description: Stored feedback. published reports whether mesh publication was confirmed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    const: true
                  id:
                    type: string
                    format: uuid
                  published:
                    type: boolean
                required:
                - ok
                - id
                - published
                additionalProperties: false
        '400':
          description: Malformed JSON or invalid fields.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid tester key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: Feedback body exceeds the configured byte limit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Tester exceeded the configured fixed-minute admission limit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Unexpected intake failure.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Feedback
      security:
      - FeedbackKey: []
    options:
      operationId: feedbackPreflight
      summary: CORS preflight
      responses:
        '204':
          description: No Content
        default:
          description: Any other failure. The body is always the Error object, with a stable `code` and a `hint`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error_2'
      tags:
      - Feedback
      security:
      - FeedbackKey: []
    servers:
    - url: http://{host}:{port}
      variables:
        host:
          default: 127.0.0.1
        port:
          default: '8787'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
      required:
      - error
    Feedback:
      type: object
      properties:
        origin:
          type: string
          enum:
          - human
          - agent
        type:
          type: string
          enum:
          - bug
          - idea
          - friction
          - praise
          - other
        summary:
          type: string
          minLength: 1
          maxLength: 300
        severity:
          type: string
          enum:
          - low
          - medium
          - high
        client: {}
        diagnostics: {}
        details:
          type:
          - string
          - 'null'
          maxLength: 10000
        area:
          type:
          - string
          - 'null'
          maxLength: 120
        repro:
          type:
          - string
          - 'null'
          maxLength: 10000
        expected:
          type:
          - string
          - 'null'
          maxLength: 5000
        actual:
          type:
          - string
          - 'null'
          maxLength: 5000
        source:
          type:
          - string
          - 'null'
          maxLength: 40
      required:
      - origin
      - type
      - summary
      description: Strings are trimmed before length checks. Empty or null optional strings are omitted. Unknown properties are discarded. client and diagnostics accept arbitrary JSON.
    Error_2:
      type: object
      description: Every failure, on every endpoint. Never an HTML page.
      required:
      - ok
      - error
      - code
      properties:
        ok:
          type: boolean
          const: false
        error:
          type: string
          description: Human-readable message.
        code:
          type: string
          enum:
          - bad_request
          - validation_error
          - unauthorized
          - forbidden
          - not_found
          - method_not_allowed
          - conflict
          - payload_too_large
          - rate_limited
          - storage_error
          description: Stable, machine-readable error code.
        hint:
          type: string
          description: How to recover.
        docs:
          type: string
          format: uri
          description: Where the contract is documented.
  securitySchemes:
    FeedbackKey:
      type: http
      scheme: bearer
      description: Provisioned tester key. The bearer scheme is case-insensitive; the key is trimmed.
    bearerKey:
      type: http
      scheme: bearer
      bearerFormat: ctk_…
      description: 'Registered Cotal tester/agent key. How to get one: https://cotal.ai/auth.md'
    adminKey:
      type: http
      scheme: bearer
      bearerFormat: cpa_…
      description: 'Admin key of the Cotal team, accepted on /v1/posts only: stage and revise every post. It cannot publish; that is a human click in the private area. Not issued to outside callers.'
externalDocs:
  description: Cotal documentation
  url: https://docs.cotal.ai
x-refined-from:
- cotal-ai-feedback-intake-openapi.json
- cotal-ai-public-api-openapi.json
- cotal-ai-feedback-intake-openapi.yml
x-source: implementations/auth/src/service.ts ROUTES and loopback handlers