Skip to main content
POST
/
organisations
/
{orgId}
/
workspaces
/
{workspaceId}
/
insights
Create new insight
curl --request POST \
  --url https://api.meetsquad.ai/organisations/{orgId}/workspaces/{workspaceId}/insights \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "Feedback",
  "title": "Dashboard UX Improvements",
  "description": "The dashboard could use better data visualization",
  "organisationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ownerId": "d4e71c2b-a498-42af-b7f5-69de06a0d7c4",
  "strengthScore": 0.75,
  "momentumScore": 0.5,
  "combinedScore": 0.65,
  "lastScoreCalculatedAt": "2025-03-26T22:35:46Z",
  "topicEmbeddings": [
    0.1,
    -0.2,
    0.3
  ],
  "seen": true,
  "feedbackIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'
{
  "data": {
    "id": "d231fe70-9585-4657-9c4e-6b431bbc1b6a",
    "type": "Feedback",
    "title": "Dashboard UX Improvements",
    "description": "The dashboard could use better data visualization",
    "seen": false,
    "hideContent": false,
    "createdAt": "2025-03-26T22:35:46Z",
    "updatedAt": "2025-03-26T22:35:46Z",
    "opportunities": [],
    "solutions": [],
    "outcomes": [],
    "feedback": [],
    "strength": 5,
    "ownerId": "d4e71c2b-a498-42af-b7f5-69de06a0d7c4",
    "strengthScore": 0.75,
    "momentumScore": 0.5,
    "combinedScore": 0.65,
    "lastScoreCalculatedAt": "2025-03-26T22:35:46Z",
    "topicEmbeddings": [
      0.1,
      -0.2,
      0.3
    ]
  }
}

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
​
type
enum<string>
required

Type of insight

Available options:
Feedback,
Bug,
FeatureRequest
Example:

"Feedback"

​
title
string
required

Title of the insight

Example:

"Dashboard UX Improvements"

​
description
string
required

Description of the insight

Example:

"The dashboard could use better data visualization"

​
organisationId
string<uuid>
required
​
workspaceId
string<uuid>
required
​
id
string<uuid>
​
ownerId
string

ID of the insight owner

Example:

"d4e71c2b-a498-42af-b7f5-69de06a0d7c4"

​
strengthScore
number

Wilson score + corroboration score (0-1)

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

0.75

​
momentumScore
number

Recency and burst detection score

Required range: x >= 0
Example:

0.5

​
combinedScore
number

Weighted composite of strength and momentum scores

Required range: x >= 0
Example:

0.65

​
lastScoreCalculatedAt
string<date-time>

ISO timestamp of last score calculation

Example:

"2025-03-26T22:35:46Z"

​
topicEmbeddings
number[]

BERT embeddings for topic modeling

Example:
[0.1, -0.2, 0.3]
​
seen
boolean
​
feedbackIds
string<uuid>[]

Response

Insight created successfully

Response containing a single insight item

​
data
object
required

Insight data