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/ydb-qdrant-tech:ydb-qdrant-tech-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: Gravity AI UI Feedback API
  version: 1.0.0
  description: API, MCP, and discovery surfaces for Gravity AI UI, an agent-ready generator for validated A2UI and Gravity UI product interfaces.
  contact:
    name: Gravity AI UI
    url: https://gravity-ai.ydb-qdrant.tech/docs
  license:
    name: Apache-2.0
servers:
- url: https://gravity-ai.ydb-qdrant.tech
tags:
- name: Feedback
  description: Publish liked generated interfaces.
paths:
  /api/design-feedback:
    post:
      operationId: publishDesignFeedback
      tags:
      - Feedback
      summary: Publish liked interface feedback to the public gallery
      description: Stores a liked composed interface payload and schedules gallery thumbnail generation. Current public demo accepts only positive published feedback from the app flow.
      parameters:
      - $ref: '#/components/parameters/ApiVersionHeader'
      - name: Idempotency-Key
        in: header
        required: false
        schema:
          type: string
          minLength: 1
          maxLength: 200
        description: Optional caller-provided retry key. The current demo documents the header for agent retry planning; durable idempotency is not enforced.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DesignFeedbackRequest'
      responses:
        '200':
          description: Feedback was stored and a gallery id was created.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                type: object
                required:
                - feedbackId
                - galleryId
                - rating
                - createdAtMs
                properties:
                  feedbackId:
                    type: string
                  galleryId:
                    type: string
                  rating:
                    type: integer
                    const: 1
                  createdAtMs:
                    type: integer
        '400':
          description: Invalid design feedback.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '503':
          description: Feedback storage unavailable.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    ComposedInterfacePayload:
      type: object
      additionalProperties: false
      required:
      - sequence
      - surfaceId
      - root
      - nodes
      properties:
        sequence:
          type: integer
          minimum: 0
          maximum: 10000
        surfaceId:
          type: string
          minLength: 1
          maxLength: 80
        dataModel: {}
        root:
          type: object
          required:
          - component
          properties:
            component:
              type: string
              enum:
              - Column
              - Row
            props:
              type: object
        nodes:
          type: array
          maxItems: 120
          items:
            type: object
            required:
            - id
            - component
            properties:
              id:
                type: string
              parentId:
                type:
                - string
                - 'null'
              order:
                type: integer
                minimum: 0
              component:
                type: string
              props:
                type: object
    DesignFeedbackRequest:
      type: object
      additionalProperties: false
      required:
      - conversationId
      - turnId
      - rating
      - publish
      - payload
      properties:
        conversationId:
          type: string
          minLength: 1
          maxLength: 120
        turnId:
          type: string
          minLength: 1
          maxLength: 160
        rating:
          type: integer
          const: 1
        publish:
          type: boolean
          const: true
        prompt:
          type: string
          maxLength: 6000
        payload:
          $ref: '#/components/schemas/ComposedInterfacePayload'
        messages:
          type: array
          maxItems: 12
          items: {}
        dataModel: {}
        conversationContext:
          type: object
    ProblemDetails:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
            message:
              type: string
            docs:
              type: string
              format: uri
            issues: {}
  parameters:
    ApiVersionHeader:
      name: API-Version
      in: header
      required: false
      schema:
        type: string
        enum:
        - '1'
        default: '1'
      description: 'Optional API version selector. The current public API version is 1 and responses echo API-Version: 1.'
  securitySchemes:
    OAuth2Metadata:
      type: oauth2
      description: Discovery metadata is published for agent compatibility. Token issuance is disabled in the current public demo.
      flows:
        authorizationCode:
          authorizationUrl: https://gravity-ai.ydb-qdrant.tech/oauth/authorize
          tokenUrl: https://gravity-ai.ydb-qdrant.tech/oauth/token
          scopes:
            interface:generate: Generate and refine interfaces.
            interface:read: Read public gallery interfaces.