> ## 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. # List insights > Lists all insights in the specified workspace ## OpenAPI ````yaml /openapi/squad-api.json get /organisations/{orgId}/workspaces/{workspaceId}/insights 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}/insights: get: tags: - Insights summary: List insights description: Lists all insights in the specified workspace operationId: listInsights 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 - $ref: '#/components/parameters/InsightRelationshipsParam' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/InsightArrayResponse' '401': description: Unauthorized - Authentication required content: application/json: schema: description: Unauthorized - Missing or invalid authentication token type: object properties: error: type: object properties: code: description: Error code identifier example: UNAUTHORISED_ERROR type: string description: description: Human-readable error description example: User is unauthenticated type: string required: - code - description additionalProperties: false required: - error additionalProperties: false '403': description: Forbidden - Insufficient permissions content: application/json: schema: description: Forbidden - Insufficient permissions to access this resource type: object properties: error: type: object properties: code: description: Error code identifier example: UNAUTHORISED_ERROR type: string description: description: Human-readable error description example: User is unauthorised type: string required: - code - description additionalProperties: false required: - error additionalProperties: false '500': description: Internal Server Error content: application/json: schema: description: >- Internal Server Error - An unexpected error occurred on the server type: object properties: error: type: object properties: code: description: Error code identifier example: INTERNAL_SERVER_ERROR type: string description: description: Human-readable error description example: An unexpected error occurred on the server type: string required: - code - description additionalProperties: false required: - error additionalProperties: false security: - bearerAuth: [] components: parameters: InsightRelationshipsParam: in: query name: relationships schema: type: string required: false description: Comma-separated list of relationships to include in the response example: opportunities,solutions,outcomes schemas: InsightArrayResponse: description: Response containing an array of insight items type: object properties: data: description: Array of insight items type: array items: $ref: '#/components/schemas/InsightWithRelationships' required: - data additionalProperties: false InsightWithRelationships: description: Insight with relationships (legacy - use InsightWithRelationships) 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 opportunities: default: [] type: array items: $ref: '#/components/schemas/Opportunity' solutions: default: [] type: array items: $ref: '#/components/schemas/Solution' outcomes: default: [] type: array items: $ref: '#/components/schemas/Outcome' feedback: default: [] type: array items: $ref: '#/components/schemas/Feedback' strength: description: The number of connections this insight has to other entities example: 5 default: 0 type: number required: - id - type - title - description - seen - hideContent - createdAt - updatedAt - opportunities - solutions - outcomes - feedback - strength additionalProperties: false 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 Solution: description: Solution data for an opportunity 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)$ systemPrompt: description: System prompt used to generate the requirement example: Hello type: string aiProcessingState: description: Current state of AI processing example: FINISHED type: string enum: - INITIAL - PROCESSING - FINISHED - ERROR refinementLog: description: Log of refinements made to the requirement example: [] type: array items: type: object properties: id: description: Unique identifier for the log entry example: 96dafa28-1e01-4ba4-a92b-babb8b792823 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)$ role: description: Role of the entity making the log entry example: assistant type: string enum: - user - assistant content: description: Content of the log entry example: Initial requirement type: string required: - id - role - content additionalProperties: false title: description: Title of the solution example: Implement Single Sign-On type: string description: description: Description of the solution example: Integrate with OAuth providers to simplify user login experience type: string status: description: Solution status example: Backlog type: string enum: - Backlog - New - Planned - InDevelopment - Complete - Cancelled - Live pros: description: List of pros/advantages for this solution example: - Improved security - Simplified login flow - Reduced password reset requests type: array items: type: string cons: description: List of cons/disadvantages for this solution example: - Requires integration with external providers - May add complexity to registration type: array items: type: string hideContent: description: Whether the solution content should be hidden example: false type: boolean createdBy: description: How the solution was created example: generated type: string enum: - user - generated ownerId: description: ID of the solution owner example: d4e71c2b-a498-42af-b7f5-69de06a0d7c4 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 priority: description: >- User indicated priority for the solution (fractional-indexing string) example: a0 type: string prd: description: Product Requirements Document content for the solution example: 'Objective: Help users easily create...' type: string horizon: description: Time horizon for the solution example: now type: string enum: - now - next - later required: - id - aiProcessingState - refinementLog - title - description - status - pros - cons - hideContent - createdBy - createdAt - updatedAt - priority - prd additionalProperties: false Outcome: description: Outcome data representing a business objective type: object properties: id: description: Unique identifier for the outcome example: 7b9e5d2c-f314-48a9-be56-9843a2f6c019 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 outcome example: Increase User Engagement type: string description: description: Detailed description of the outcome example: We aim to increase daily active users by 25% in Q3 type: string priority: description: Priority level of the outcome example: 1 type: number trend: description: Trend indicator for the outcome example: 0 type: number analyticEvents: description: List of analytic events associated with the outcome example: - event1 - event2 type: array items: type: string hideContent: description: Whether the outcome is hidden example: false type: boolean ownerId: description: ID of the owner of the outcome example: 7b9e5d2c-f314-48a9-be56-9843a2f6c019 type: string createdAt: description: Timestamp of when the outcome was created example: '2023-01-01T00:00:00.000Z' type: string updatedAt: description: Timestamp of when the outcome was last updated example: '2023-01-01T00:00:00.000Z' type: string required: - id - title - description - priority - hideContent - createdAt - updatedAt additionalProperties: false Feedback: description: Raw feedback data from a user type: object properties: id: description: Unique identifier for the feedback 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)$ content: description: 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. type: string source: description: Source of the feedback example: Customer Interview type: string minLength: 2 maxLength: 100 sourceId: description: ID of the source from which feedback was imported example: interview_456 type: string sourceUrl: description: URL of the source from which feedback was imported example: https://basiliskai.slack.com/archives/C053AKR0669/p1744748012159779 type: string format: uri submittedBy: description: ID of the user who submitted this feedback example: user_123 type: string processed: description: Whether this feedback has been processed into insights example: false type: boolean sentimentScore: description: Sentiment score from -1 (negative) to 1 (positive) example: 0.75 type: number minimum: -1 maximum: 1 sentimentCategory: description: Sentiment classification category example: Positive type: string enum: - Positive - Neutral - Negative sentimentConfidence: description: Confidence in sentiment analysis (0-1) example: 0.95 type: number minimum: 0 maximum: 1 createdAt: description: Creation timestamp example: '2025-03-26T22:35:46Z' type: string createdAtEpoch: description: Unix epoch timestamp for efficient Neo4j queries example: 1679867746 type: number title: description: Short title summarizing the feedback example: Dashboard charts are hard to understand type: string updatedAt: description: Last update timestamp example: '2025-03-26T22:35:46Z' type: string required: - id - content - source - processed - createdAt - updatedAt additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: JWT authentication for organization-scoped endpoints. ````