Skip to main content
POST
/
organisations
/
{orgId}
/
workspaces
/
{workspaceId}
/
topics
Create new topic
curl --request POST \
  --url https://api.meetsquad.ai/organisations/{orgId}/workspaces/{workspaceId}/topics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "User Interface Improvements",
  "description": "General insight related to UI/UX improvements",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "opportunityIds": [
    "d4e71c2b-a498-42af-b7f5-69de06a0d7c4"
  ],
  "insightIds": [
    "d4e71c2b-a498-42af-b7f5-69de06a0d7c4"
  ]
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "User Interface Improvements",
    "description": "General insight related to UI/UX improvements",
    "createdAt": "2025-03-26T22:35:46Z",
    "updatedAt": "2025-03-26T22:35:46Z",
    "opportunities": [],
    "insights": []
  }
}

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 a topic

​
title
string
required

Title of the topic

Example:

"User Interface Improvements"

​
description
string
required

Description of the topic

Example:

"General insight related to UI/UX improvements"

​
id
string<uuid>
​
opportunityIds
string[]

List of opportunity IDs associated with the topic

Example:
["d4e71c2b-a498-42af-b7f5-69de06a0d7c4"]
​
insightIds
string[]

List of insight IDs associated with the topic

Example:
["d4e71c2b-a498-42af-b7f5-69de06a0d7c4"]

Response

Topic created successfully

Response containing a single topic

​
data
object
required

Topic data