> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetsquad.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create new feedback

> Creates a new feedback item in the specified workspace and automatically queues it for processing



## OpenAPI

````yaml /openapi/squad-api.json post /organisations/{orgId}/workspaces/{workspaceId}/feedback
openapi: 3.1.0
info:
  title: Squad API
  version: 4.8.0
  description: API for managing Squad resources
  contact:
    name: Squad Support
    url: https://www.meetsquad.ai/support
    email: help@meetsquad.ai
servers:
  - url: https://api.meetsquad.ai
    description: Production server
  - url: https://uat.api.meetsquad.ai
    description: Staging server
  - url: https://dev.api.meetsquad.ai
    description: Development server
security: []
tags:
  - name: Organisations
  - name: Workspaces
  - name: Goals
  - name: Opportunities
  - name: Solutions
  - name: Feedback
  - name: Submit Feedback
  - name: Insights
  - name: Knowledge
  - name: Metrics
  - name: Topics
  - name: Integrations
  - name: AI & Search
  - name: Onboarding
paths:
  /organisations/{orgId}/workspaces/{workspaceId}/feedback:
    post:
      tags:
        - Feedback
      summary: Create new feedback
      description: >-
        Creates a new feedback item in the specified workspace and automatically
        queues it for processing
      operationId: createFeedback
      parameters:
        - in: path
          name: orgId
          schema:
            type: string
          required: true
          description: Organization ID
          example: a5f3c6e1-9d20-4f7b-8e31-d09a2b63c184
        - in: path
          name: workspaceId
          schema:
            type: string
          required: true
          description: Workspace ID
          example: c0e195d9-b918-4a3a-bd8b-f730361d044f
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFeedbackRequest'
      responses:
        '200':
          description: Feedback created successfully
          content:
            application/json:
              schema:
                description: Response containing a single feedback item
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/FeedbackWithRelationships'
                    description: Feedback data
                required:
                  - data
                additionalProperties: false
        '400':
          description: Bad Request - Invalid input
          content:
            application/json:
              schema:
                description: >-
                  Bad Request - Invalid input parameters or missing required
                  fields
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        description: Error code identifier
                        example: INVALID_REQUEST
                        type: string
                      description:
                        description: Human-readable error description
                        example: One or more fields are invalid
                        type: string
                      fields:
                        description: List of field names that are missing or invalid
                        example:
                          - title
                          - description
                        type: array
                        items:
                          type: string
                      validationErrors:
                        description: >-
                          Detailed validation error information for each invalid
                          field
                        example:
                          invalidFields:
                            title:
                              type: too_small
                              message: Title must be at least 3 characters long
                              path:
                                - title
                            deadline:
                              type: invalid_date
                              message: Deadline must be a valid date in the future
                              path:
                                - deadline
                        type: object
                        propertyNames:
                          type: string
                        additionalProperties: {}
                    required:
                      - code
                      - description
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
        '401':
          description: Unauthorized - Authentication required
          content:
            application/json:
              schema:
                description: Unauthorized - Missing or invalid authentication token
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        description: Error code identifier
                        example: UNAUTHORISED_ERROR
                        type: string
                      description:
                        description: Human-readable error description
                        example: User is unauthenticated
                        type: string
                    required:
                      - code
                      - description
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
        '403':
          description: Forbidden - Insufficient permissions
          content:
            application/json:
              schema:
                description: Forbidden - Insufficient permissions to access this resource
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        description: Error code identifier
                        example: UNAUTHORISED_ERROR
                        type: string
                      description:
                        description: Human-readable error description
                        example: User is unauthorised
                        type: string
                    required:
                      - code
                      - description
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                description: >-
                  Internal Server Error - An unexpected error occurred on the
                  server
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        description: Error code identifier
                        example: INTERNAL_SERVER_ERROR
                        type: string
                      description:
                        description: Human-readable error description
                        example: An unexpected error occurred on the server
                        type: string
                    required:
                      - code
                      - description
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
      security:
        - bearerAuth: []
components:
  schemas:
    CreateFeedbackRequest:
      description: Request schema for creating feedback
      type: object
      properties:
        content:
          description: Original raw feedback content
          example: >-
            I found the dashboard charts difficult to understand at first
            glance. The colors are confusing and the data is hard to interpret.
          type: string
        source:
          description: Source of the feedback
          example: Customer Interview
          type: string
          minLength: 2
          maxLength: 100
        sourceId:
          description: ID of the source from which feedback was imported
          example: interview_456
          type: string
        sourceUrl:
          description: URL of the source from which feedback was imported
          example: https://basiliskai.slack.com/archives/C053AKR0669/p1744748012159779
          type: string
          format: uri
        sentimentScore:
          description: Sentiment score from -1 (negative) to 1 (positive)
          example: 0.75
          type: number
          minimum: -1
          maximum: 1
        sentimentCategory:
          description: Sentiment classification category
          example: Positive
          type: string
          enum:
            - Positive
            - Neutral
            - Negative
        sentimentConfidence:
          description: Confidence in sentiment analysis (0-1)
          example: 0.95
          type: number
          minimum: 0
          maximum: 1
        createdAtEpoch:
          description: Unix epoch timestamp for efficient Neo4j queries
          example: 1679867746
          type: number
        title:
          description: Short title summarizing the feedback
          example: Dashboard charts are hard to understand
          type: string
        id:
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        createdAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        updatedAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
      required:
        - content
        - source
    FeedbackWithRelationships:
      description: Raw feedback with generated insights
      type: object
      properties:
        id:
          description: Unique identifier for the feedback
          example: f5d8df32-60b4-417a-8b83-8d4dcb4e88e1
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        content:
          description: Original raw feedback content
          example: >-
            I found the dashboard charts difficult to understand at first
            glance. The colors are confusing and the data is hard to interpret.
          type: string
        source:
          description: Source of the feedback
          example: Customer Interview
          type: string
          minLength: 2
          maxLength: 100
        sourceId:
          description: ID of the source from which feedback was imported
          example: interview_456
          type: string
        sourceUrl:
          description: URL of the source from which feedback was imported
          example: https://basiliskai.slack.com/archives/C053AKR0669/p1744748012159779
          type: string
          format: uri
        submittedBy:
          description: ID of the user who submitted this feedback
          example: user_123
          type: string
        processed:
          description: Whether this feedback has been processed into insights
          example: false
          type: boolean
        sentimentScore:
          description: Sentiment score from -1 (negative) to 1 (positive)
          example: 0.75
          type: number
          minimum: -1
          maximum: 1
        sentimentCategory:
          description: Sentiment classification category
          example: Positive
          type: string
          enum:
            - Positive
            - Neutral
            - Negative
        sentimentConfidence:
          description: Confidence in sentiment analysis (0-1)
          example: 0.95
          type: number
          minimum: 0
          maximum: 1
        createdAt:
          description: Creation timestamp
          example: '2025-03-26T22:35:46Z'
          type: string
        createdAtEpoch:
          description: Unix epoch timestamp for efficient Neo4j queries
          example: 1679867746
          type: number
        title:
          description: Short title summarizing the feedback
          example: Dashboard charts are hard to understand
          type: string
        updatedAt:
          description: Last update timestamp
          example: '2025-03-26T22:35:46Z'
          type: string
        insights:
          default: []
          type: array
          items:
            $ref: '#/components/schemas/Insight'
        opportunities:
          default: []
          type: array
          items:
            $ref: '#/components/schemas/Opportunity'
        metadata:
          description: >-
            Array of metadata objects from nodes that provided this feedback,
            each with a nodeType discriminator
          example:
            - nodeType: IntercomConversation
              conversationId: '123456789'
              url: >-
                https://app.intercom.com/a/apps/abc/inbox/inbox/conversation/123456789
              createdAt: '2024-01-01T00:00:00Z'
              updatedAt: '2024-01-02T00:00:00Z'
          default: []
          type: array
          items:
            $ref: '#/components/schemas/FeedbackMetadataItem'
      required:
        - id
        - content
        - source
        - processed
        - createdAt
        - updatedAt
        - insights
        - opportunities
        - metadata
      additionalProperties: false
    Insight:
      description: Insight data from a user
      type: object
      properties:
        id:
          description: Unique identifier for the insight
          example: d231fe70-9585-4657-9c4e-6b431bbc1b6a
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        type:
          description: Type of insight
          example: Feedback
          type: string
          enum:
            - Feedback
            - Bug
            - FeatureRequest
        title:
          description: Title of the insight
          example: Dashboard UX Improvements
          type: string
        description:
          description: Description of the insight
          example: The dashboard could use better data visualization
          type: string
        seen:
          description: Whether the insight has been seen
          example: false
          type: boolean
        hideContent:
          description: Whether the insight content should be hidden
          example: false
          type: boolean
        ownerId:
          description: ID of the insight owner
          example: d4e71c2b-a498-42af-b7f5-69de06a0d7c4
          type: string
        strengthScore:
          description: Wilson score + corroboration score (0-1)
          example: 0.75
          type: number
          minimum: 0
          maximum: 1
        momentumScore:
          description: Recency and burst detection score
          example: 0.5
          type: number
          minimum: 0
        combinedScore:
          description: Weighted composite of strength and momentum scores
          example: 0.65
          type: number
          minimum: 0
        lastScoreCalculatedAt:
          description: ISO timestamp of last score calculation
          example: '2025-03-26T22:35:46Z'
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        topicEmbeddings:
          description: BERT embeddings for topic modeling
          example:
            - 0.1
            - -0.2
            - 0.3
          type: array
          items:
            type: number
        createdAt:
          description: Creation timestamp
          example: '2025-03-26T22:35:46Z'
          type: string
        updatedAt:
          description: Last update timestamp
          example: '2025-03-26T22:35:46Z'
          type: string
      required:
        - id
        - type
        - title
        - description
        - seen
        - hideContent
        - createdAt
        - updatedAt
      additionalProperties: false
    Opportunity:
      description: Opportunity data for a business
      type: object
      properties:
        id:
          description: Unique identifier for the opportunity
          example: f5d8df32-60b4-417a-8b83-8d4dcb4e88e1
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        read:
          description: Whether the opportunity has been read
          example: false
          type: boolean
        status:
          description: Current status of the opportunity
          example: New
          type: string
          enum:
            - New
            - Solved
            - Planned
            - InProgress
        title:
          description: Title of the opportunity
          example: Improve Customer Onboarding Experience
          type: string
        description:
          description: Description of the opportunity
          example: Streamline the initial user setup process to reduce drop-offs
          type: string
        solutionsGeneratingState:
          description: Current state of solution generation
          example: initial
          type: string
          enum:
            - generating
            - generated
            - initial
            - error
        createdBy:
          description: How the opportunity was created
          example: user
          type: string
          enum:
            - user
            - generated
        hideContent:
          description: Whether the opportunity content should be hidden
          example: false
          type: boolean
        ownerId:
          description: ID of the opportunity owner
          example: d4e71c2b-a498-42af-b7f5-69de06a0d7c4
          type: string
        createdAt:
          description: Creation timestamp
          example: '2023-01-01T00:00:00.000Z'
          type: string
        updatedAt:
          description: Last update timestamp
          example: '2023-01-01T00:00:00.000Z'
          type: string
      required:
        - id
        - read
        - status
        - title
        - description
        - solutionsGeneratingState
        - createdBy
        - hideContent
        - createdAt
        - updatedAt
      additionalProperties: false
    FeedbackMetadataItem:
      description: >-
        Metadata from a provider node that supplied this feedback. Contains
        nodeType and additional provider-specific properties.
      type: object
      properties:
        nodeType:
          description: >-
            The type of node that provided this feedback (e.g.,
            'IntercomConversation')
          example: IntercomConversation
          type: string
      required:
        - nodeType
      additionalProperties:
        anyOf:
          - type: string
          - type: number
          - type: boolean
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT authentication for organization-scoped endpoints.

````