> ## 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. # Update topic > Updates a specific topic by ID ## OpenAPI ````yaml /openapi/squad-api.json put /organisations/{orgId}/workspaces/{workspaceId}/topics/{topicId} 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}/topics/{topicId}: put: tags: - Topics summary: Update topic description: Updates a specific topic by ID operationId: updateTopic 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 - in: path name: topicId schema: type: string required: true description: Topic ID example: d4e71c2b-a498-42af-b7f5-69de06a0d7c4 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateTopicPayload' responses: '200': description: Topic updated successfully content: application/json: schema: description: Response containing a single topic type: object properties: data: description: Topic data type: object properties: 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)$ title: description: Title of the topic example: User Interface Improvements type: string description: description: Description of the topic example: General insight related to UI/UX improvements type: string 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 opportunities: default: [] type: array items: $ref: '#/components/schemas/Opportunity' insights: default: [] type: array items: $ref: '#/components/schemas/Insight' required: - id - title - description - createdAt - updatedAt - opportunities - insights additionalProperties: false required: - data additionalProperties: false '400': description: Bad Request - Invalid input '401': description: Unauthorized - Authentication required '403': description: Forbidden - Insufficient permissions '404': description: Topic not found security: - bearerAuth: [] components: schemas: UpdateTopicPayload: description: Request schema for updating a topic type: object properties: title: description: Title of the topic example: User Interface Improvements type: string description: description: Description of the topic example: General insight related to UI/UX improvements type: string opportunityIds: description: List of opportunity IDs associated with the topic example: - d4e71c2b-a498-42af-b7f5-69de06a0d7c4 type: array items: type: string insightIds: description: List of insight IDs associated with the topic example: - d4e71c2b-a498-42af-b7f5-69de06a0d7c4 type: array items: type: string 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 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 securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: JWT authentication for organization-scoped endpoints. ````