vCita AI Generation Feedback API

Operations related to AI generation feedback management

GitHub OpenAPI

Operations 1

POST /v3/ai/ai_generation_feedbacks Create new AI generation feedback #

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/vcita:vcita-ai-generation-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

vcita-ai-generation-feedback-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AI Generation Feedback API
  description: Unified OpenAPI specification for ai domain
  version: '3.0'
  x-generated:
    sourceFiles:
    - recommendations.json
    - business_rules.json
    - business_ai_settings.json
    - bizai.json
    - ai_smart_reply.json
    - generic_ai.json
    - staff_ai_settings.json
    - ai_generation_feedback.json
    pathNormalizations: []
    pathConflicts: []
    componentConflicts:
    - type: schema
      name: ErrorResponse
      resolution: Renamed to ErrorResponse_business_rules
      files:
      - merged
      - business_rules.json
    - type: schema
      name: ErrorResponse
      resolution: Renamed to ErrorResponse_business_ai_settings
      files:
      - merged
      - business_ai_settings.json
    - type: schema
      name: Response
      resolution: Renamed to Response_ai_smart_reply
      files:
      - merged
      - ai_smart_reply.json
    - type: schema
      name: ErrorResponse
      resolution: Renamed to ErrorResponse_staff_ai_settings
      files:
      - merged
      - staff_ai_settings.json
    totalPaths: 20
    totalComponents: 33
servers:
- url: https://api.vcita.biz
  description: Unified API Gateway server
tags:
- name: AI Generation Feedback
  description: Operations related to AI generation feedback management
paths:
  /v3/ai/ai_generation_feedbacks:
    post:
      tags:
      - AI Generation Feedback
      summary: Create new AI generation feedback
      description: '## Overview

        Submit feedback for AI-generated content.


        **Available for Staff tokens**'
      operationId: createAiGenerationFeedback
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AiGenerationFeedbackRequest'
      responses:
        '201':
          description: Feedback created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      uid:
                        type: string
                        description: The unique identifier (UID) of the AI generation feedback
                      created_at:
                        type: string
                        format: date-time
                        description: The timestamp when the feedback was created, in ISO 8601 format
                      updated_at:
                        type: string
                        format: date-time
                        description: The timestamp when the feedback was last updated, in ISO 8601 format
                      type:
                        type: string
                        description: The type of feedback provided
                        enum:
                        - int
                        - decimal
                        - text
                        - boolean
                      value:
                        type: string
                        description: The feedback value - stored as string regardless of feedback type (e.g., '4.5' for score, 'true' for boolean)
                      entity_type:
                        type: string
                        description: The type of entity this feedback is related to
                        enum:
                        - AISmartReply
                        - AIRecommendation
                        - AIRecommendedAction
                      name:
                        type: string
                        description: The specific name/identifier for the feedback type
                        enum:
                        - '[AISmartReply] Business Sent Message UID'
                        - '[AISmartReply] Business Dismiss Reason'
                      entity_uid:
                        type: string
                        description: The unique identifier of the related entity
                    required:
                    - uid
                    - created_at
                    - updated_at
                    - type
                    - value
                    - entity_type
                    - entity_uid
                    - name
                    examples:
                    - uid: fb-decimal-001
                      created_at: '2025-02-04T14:15:00.000Z'
                      updated_at: '2025-02-04T14:15:00.000Z'
                      type: decimal
                      value: '4.5'
                      entity_type: AIRecommendation
                      entity_uid: rec-d290f1ee-6c54-4b01-90e6-d701748f0851
                      name: '[AISmartReply] Business Sent Message UID'
                    - uid: fb-bool-002
                      created_at: '2025-02-04T14:20:00.000Z'
                      updated_at: '2025-02-04T14:20:00.000Z'
                      type: boolean
                      value: 'true'
                      entity_type: AISmartReply
                      entity_uid: sr-123
                      name: '[AISmartReply] Business Dismiss Reason'
                    - uid: fb-text-003
                      created_at: '2025-02-04T14:25:00.000Z'
                      updated_at: '2025-02-04T14:25:00.000Z'
                      type: text
                      value: Great suggestion
                      entity_type: AIRecommendedAction
                      entity_uid: action-abc123
                      name: '[AISmartReply] Business Sent Message UID'
                    description: Captures feedback on AI-generated outputs linked to specific entities.
        '400':
          description: Invalid request parameters
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Entity not found - The referenced `entity_uid` does not exist for the specified `entity_type`
      security:
      - Bearer: []
components:
  schemas:
    AiGenerationFeedbackRequest:
      type: object
      properties:
        type:
          type: string
          description: The type of feedback provided
          enum:
          - int
          - decimal
          - text
          - boolean
        value:
          type: string
          description: The feedback value - stored as string regardless of feedback type (e.g., '4.5' for decimal, 'true' for boolean)
        entity_type:
          type: string
          description: The type of entity this feedback is related to
          enum:
          - AISmartReply
          - AIRecommendation
          - AIRecommendedAction
        entity_uid:
          type: string
          format: uuid
          description: 'The unique identifier of the related entity. **Important**: You must first create or retrieve an entity of the specified `entity_type`, then use its UID here. For example:


            1. Create an AISmartReply via `POST /v3/ai/ai_smart_replies`

            2. Use the returned `uid` as `entity_uid` with `entity_type=''AISmartReply''`


            Returns 404 if the entity does not exist.'
          example: d290f1ee-6c54-4b01-90e6-d701748f0851
        name:
          type: string
          description: The specific name/identifier for the feedback type
          enum:
          - '[AISmartReply] Business Sent Message UID'
          - '[AISmartReply] Business Dismiss Reason'
      required:
      - type
      - value
      - entity_type
      - entity_uid
      - name
      example:
        type: text
        value: too_formal
        entity_type: AISmartReply
        entity_uid: d290f1ee-6c54-4b01-90e6-d701748f0851
        name: '[AISmartReply] Business Dismiss Reason'
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Provide a valid bearer token in the Authorization header. Example: ''Authorization: Bearer {app_token}'''
x-provenance:
  method: searched
  source: https://developers.intandem.tech:443/reference
  harvested: '2026-11-15'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developers.intandem.tech/reference/businessrulescontroller_createbulkimportjob.md
  - https://developers.intandem.tech/reference/businessrulescontroller_createbusinessrule.md
  - https://developers.intandem.tech/reference/businessrulescontroller_deletebusinessrule.md
  - https://developers.intandem.tech/reference/businessrulescontroller_getbusinessrule.md
  - https://developers.intandem.tech/reference/businessrulescontroller_getbusinessrules.md
  - https://developers.intandem.tech/reference/businessrulescontroller_gethistory.md
  - https://developers.intandem.tech/reference/businessrulescontroller_gethistoryrecord.md
  - https://developers.intandem.tech/reference/businessrulescontroller_updatebusinessrule.md
  - https://developers.intandem.tech/reference/chatmessagescontroller_createmessage.md
  - https://developers.intandem.tech/reference/chatmessagescontroller_getmessages.md
  - https://developers.intandem.tech/reference/chatscontroller_createchat.md
  - https://developers.intandem.tech/reference/chatscontroller_getchat.md
  - https://developers.intandem.tech/reference/chatscontroller_getchats.md
  - https://developers.intandem.tech/reference/createaigenerationfeedback.md
  - https://developers.intandem.tech/reference/get_v3-ai-ai-recommendations.md
  - https://developers.intandem.tech/reference/get_v3-ai-ai-smart-replies.md
  - https://developers.intandem.tech/reference/get_v3-ai-chat-completion-runs-uid.md
  - https://developers.intandem.tech/reference/get_v3-ai-chat-completion-runs.md
  - https://developers.intandem.tech/reference/get_v3-ai-staff-ai-settings-staff-uid.md
  - https://developers.intandem.tech/reference/get_v3-ai-transcription-runs-uid.md
  - https://developers.intandem.tech/reference/get_v3-ai-transcription-runs.md
  - https://developers.intandem.tech/reference/getairecommendation.md
  - https://developers.intandem.tech/reference/getbusinessaisettings.md
  - https://developers.intandem.tech/reference/post_v3-ai-ai-recommendations.md
  - https://developers.intandem.tech/reference/post_v3-ai-ai-smart-replies.md
  - https://developers.intandem.tech/reference/post_v3-ai-audio-transcriptions.md
  - https://developers.intandem.tech/reference/post_v3-ai-chat-completions.md
  - https://developers.intandem.tech/reference/put_v3-ai-ai-recommendations-uid.md
  - https://developers.intandem.tech/reference/put_v3-ai-staff-ai-settings-staff-uid.md
  - https://developers.intandem.tech/reference/updatebusinessaisettings.md
  - https://developers.intandem.tech:443/reference/businessrulescontroller_createbulkimportjob.md
  - https://developers.intandem.tech:443/reference/businessrulescontroller_createbusinessrule.md
  - https://developers.intandem.tech:443/reference/businessrulescontroller_deletebusinessrule.md
  - https://developers.intandem.tech:443/reference/businessrulescontroller_getbusinessrule.md
  - https://developers.intandem.tech:443/reference/businessrulescontroller_getbusinessrules.md
  - https://developers.intandem.tech:443/reference/businessrulescontroller_gethistory.md
  - https://developers.intandem.tech:443/reference/businessrulescontroller_gethistoryrecord.md
  - https://developers.intandem.tech:443/reference/businessrulescontroller_updatebusinessrule.md
  - https://developers.intandem.tech:443/reference/chatmessagescontroller_createmessage.md
  - https://developers.intandem.tech:443/reference/chatmessagescontroller_getmessages.md
  - https://developers.intandem.tech:443/reference/chatscontroller_createchat.md
  - https://developers.intandem.tech:443/reference/chatscontroller_getchat.md
  - https://developers.intandem.tech:443/reference/chatscontroller_getchats.md
  - https://developers.intandem.tech:443/reference/createaigenerationfeedback.md
  - https://developers.intandem.tech:443/reference/get_v3-ai-ai-recommendations.md
  - https://developers.intandem.tech:443/reference/get_v3-ai-ai-smart-replies.md
  - https://developers.intandem.tech:443/reference/get_v3-ai-chat-completion-runs-uid.md
  - https://developers.intandem.tech:443/reference/get_v3-ai-chat-completion-runs.md
  - https://developers.intandem.tech:443/reference/get_v3-ai-staff-ai-settings-staff-uid.md
  - https://developers.intandem.tech:443/reference/get_v3-ai-transcription-runs-uid.md
  - https://developers.intandem.tech:443/reference/get_v3-ai-transcription-runs.md
  - https://developers.intandem.tech:443/reference/getairecommendation.md
  - https://developers.intandem.tech:443/reference/getbusinessaisettings.md
  - https://developers.intandem.tech:443/reference/post_v3-ai-ai-recommendations.md
  - https://developers.intandem.tech:443/reference/post_v3-ai-ai-smart-replies.md
  - https://developers.intandem.tech:443/reference/post_v3-ai-audio-transcriptions.md
  - https://developers.intandem.tech:443/reference/post_v3-ai-chat-completions.md
  - https://developers.intandem.tech:443/reference/put_v3-ai-ai-recommendations-uid.md
  - https://developers.intandem.tech:443/reference/put_v3-ai-staff-ai-settings-staff-uid.md
  - https://developers.intandem.tech:443/reference/updatebusinessaisettings.md
  merge:
    pages: 60
    deduped: 137
    conflicts_kept_first: 0