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
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)$
​
workspaceId
string<uuid>
required
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)$
​
id
string<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)$
​
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

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))$
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>[]
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)$

Response

Insight created successfully

Response containing a single insight item

​
data
object
required

Insight data