Skip to main content
POST
/
organisations
/
{orgId}
/
workspaces
/
{workspaceId}
/
feedback
Create new feedback
curl --request POST \
  --url https://api.meetsquad.ai/organisations/{orgId}/workspaces/{workspaceId}/feedback \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "I found the dashboard charts difficult to understand at first glance. The colors are confusing and the data is hard to interpret.",
  "source": "Customer Interview",
  "sourceId": "interview_456",
  "sourceUrl": "https://basiliskai.slack.com/archives/C053AKR0669/p1744748012159779",
  "sentimentScore": 0.75,
  "sentimentCategory": "Positive",
  "sentimentConfidence": 0.95,
  "createdAtEpoch": 1679867746,
  "title": "Dashboard charts are hard to understand",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}
'
{
  "data": {
    "id": "f5d8df32-60b4-417a-8b83-8d4dcb4e88e1",
    "content": "I found the dashboard charts difficult to understand at first glance. The colors are confusing and the data is hard to interpret.",
    "source": "Customer Interview",
    "processed": false,
    "createdAt": "2025-03-26T22:35:46Z",
    "updatedAt": "2025-03-26T22:35:46Z",
    "insights": [],
    "opportunities": [],
    "metadata": [
      {
        "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"
      }
    ],
    "sourceId": "interview_456",
    "sourceUrl": "https://basiliskai.slack.com/archives/C053AKR0669/p1744748012159779",
    "submittedBy": "user_123",
    "sentimentScore": 0.75,
    "sentimentCategory": "Positive",
    "sentimentConfidence": 0.95,
    "createdAtEpoch": 1679867746,
    "title": "Dashboard charts are hard to understand"
  }
}

Authorizations

​
Authorization
string
header
required

JWT authentication for organization-scoped endpoints.

Path Parameters

​
orgId
string
required

Organization ID

​
workspaceId
string
required

Workspace ID

Body

application/json

Request schema for creating feedback

​
content
string
required

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."

​
source
string
required

Source of the feedback

Required string length: 2 - 100
Example:

"Customer Interview"

​
sourceId
string

ID of the source from which feedback was imported

Example:

"interview_456"

​
sourceUrl
string<uri>

URL of the source from which feedback was imported

Example:

"https://basiliskai.slack.com/archives/C053AKR0669/p1744748012159779"

​
sentimentScore
number

Sentiment score from -1 (negative) to 1 (positive)

Required range: -1 <= x <= 1
Example:

0.75

​
sentimentCategory
enum<string>

Sentiment classification category

Available options:
Positive,
Neutral,
Negative
Example:

"Positive"

​
sentimentConfidence
number

Confidence in sentiment analysis (0-1)

Required range: 0 <= x <= 1
Example:

0.95

​
createdAtEpoch
number

Unix epoch timestamp for efficient Neo4j queries

Example:

1679867746

​
title
string

Short title summarizing the feedback

Example:

"Dashboard charts are hard to understand"

​
id
string<uuid>
​
createdAt
string<date-time>
​
updatedAt
string<date-time>

Response

Feedback created successfully

Response containing a single feedback item

​
data
object
required

Feedback data