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/samva-dev:samva-dev-feedback-api"

All apis

curl "https://apis.io/api/v1/apis?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.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Samva Feedback API
  version: 1.0.0
  description: Samva is the email API for your app. Send transactional email in one typed call. Delivery events and customer replies come back as signed webhooks, and replies thread to the email they answer.
servers:
- url: https://api.samva.dev
security: []
tags:
- name: Feedback
  description: Reports to Samva about the API itself.
paths:
  /v1/feedback:
    post:
      tags:
      - Feedback
      operationId: feedback.send
      parameters: []
      security:
      - apiKey: []
      responses:
        '201':
          description: FeedbackReceipt
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackReceipt'
        '401':
          description: UnauthorizedError
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '403':
          description: ForbiddenError
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '422':
          description: ValidationError
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '500':
          description: InternalError
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalError'
        '504':
          description: GatewayTimeoutError
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayTimeoutError'
      description: Tells Samva what was confusing, broken, or missing in the API. Programs and coding agents can call it the moment something goes wrong, naming the operation and resource involved. Samva's team reads every report; the answer is a receipt, not a reply.
      summary: Send feedback
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendFeedback'
        required: true
components:
  schemas:
    ValidationError:
      type: object
      properties:
        _tag:
          type: string
          enum:
          - ValidationError
        message:
          type: string
        fields:
          anyOf:
          - type: object
            additionalProperties:
              type: array
              items:
                type: string
          - type: 'null'
      required:
      - _tag
      - message
      additionalProperties: false
      x-category:
      - validation
      x-retryable: false
    FeedbackReceipt:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/FeedbackId'
        createdAt:
          type: string
      required:
      - id
      - createdAt
      additionalProperties: false
    GatewayTimeoutError:
      type: object
      properties:
        _tag:
          type: string
          enum:
          - GatewayTimeoutError
        message:
          type: string
        retryAfterSeconds:
          type: number
      required:
      - _tag
      - message
      - retryAfterSeconds
      additionalProperties: false
      x-category:
      - transient
      x-retryable: true
    FeedbackContext:
      type: object
      properties:
        operation:
          anyOf:
          - type: string
            minLength: 1
            maxLength: 200
            description: The operation the report is about, as an SDK method, MCP tool, CLI command, or `METHOD /path` (for example `POST /v1/messages`).
            x-samva-string-checks:
            - id: effect/schema/isMaxLength
              payload:
                maxLength: 200
          - type: 'null'
        resourceId:
          anyOf:
          - type: string
            minLength: 1
            maxLength: 200
            description: The id of the resource involved, such as a message or domain id.
            x-samva-string-checks:
            - id: effect/schema/isMaxLength
              payload:
                maxLength: 200
          - type: 'null'
      additionalProperties: false
    SendFeedback:
      type: object
      properties:
        message:
          type: string
          maxLength: 4000
          pattern: \S
          description: What happened and what you expected, in plain language (at most 4000 characters).
          x-samva-string-checks:
          - id: effect/schema/isMaxLength
            payload:
              maxLength: 4000
        category:
          anyOf:
          - type: string
            enum:
            - bug
            - confusing
            - missing
            - other
            description: '`bug`: the API behaved wrongly. `confusing`: a response, error, or doc was hard to act on. `missing`: a capability or field you needed does not exist. `other`: anything else.'
          - type: 'null'
        context:
          anyOf:
          - $ref: '#/components/schemas/FeedbackContext'
          - type: 'null'
      required:
      - message
      additionalProperties: false
    UnauthorizedError:
      type: object
      properties:
        _tag:
          type: string
          enum:
          - UnauthorizedError
        message:
          type: string
      required:
      - _tag
      - message
      additionalProperties: false
      x-category:
      - auth
      x-retryable: false
    FeedbackId:
      type: string
      pattern: ^fdbk_[0-9a-hjkmnp-tv-z]{16,24}$
      x-samva-brand: FeedbackId
    ForbiddenError:
      type: object
      properties:
        _tag:
          type: string
          enum:
          - ForbiddenError
        message:
          type: string
      required:
      - _tag
      - message
      additionalProperties: false
      x-category:
      - auth
      x-retryable: false
    InternalError:
      type: object
      properties:
        _tag:
          type: string
          enum:
          - InternalError
        message:
          type: string
      required:
      - _tag
      - message
      additionalProperties: false
      x-category:
      - transient
      x-retryable: true
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header