### GET /organisations/{orgId}/workspaces/{workspaceId}/solutions/{solutionId} Source: https://api.meetsquad.ai/openapi.json Retrieves a specific solution by ID ```markdown ### Parameters - **orgId** (string, path, required): Organization ID - **workspaceId** (string, path, required): Workspace ID - **solutionId** (string, path, required): Solution ID - **relationships** (string, query, optional): Comma-separated list of relationships to include in the response ### Responses #### 200 - Success - **data** (object) (required): Solution with relationships - **id** (string (uuid)) (required) - **systemPrompt** (string): System prompt used to generate the requirement (example: "Hello") - **aiProcessingState** (string (INITIAL|PROCESSING|FINISHED|ERROR)) (required): Current state of AI processing (example: "FINISHED") ("INITIAL"|"PROCESSING"|"FINISHED"|"ERROR") - **refinementLog** (array (object)) (required): Log of refinements made to the requirement (example: []) Array items: - **id** (string (uuid)) (required): Unique identifier for the log entry (example: "96dafa28-1e01-4ba4-a92b-babb8b792823") - **role** (string (user|assistant)) (required): Role of the entity making the log entry (example: "assistant") ("user"|"assistant") - **content** (string) (required): Content of the log entry (example: "Initial requirement") - **title** (string) (required): Title of the solution (example: "Implement Single Sign-On") - **description** (string) (required): Description of the solution (example: "Integrate with OAuth providers to simplify user login experience") - **status** (string (Backlog|New|Planned|InDevelopment|Complete|Cancelled|Live)) (required): Solution status (example: "Backlog") ("Backlog"|"New"|"Planned"|"InDevelopment"|"Complete"|"Cancelled"|"Live") - **pros** (array (string)) (required): List of pros/advantages for this solution (example: ["Improved security","Simplified login flow","Reduced password reset requests"]) - **cons** (array (string)) (required): List of cons/disadvantages for this solution (example: ["Requires integration with external providers","May add complexity to registration"]) - **hideContent** (boolean) (required): Whether the solution content should be hidden (example: false) - **createdBy** (string (user|generated)) (required): How the solution was created (example: "generated") ("user"|"generated") - **ownerId** (string): ID of the solution owner (example: "d4e71c2b-a498-42af-b7f5-69de06a0d7c4") - **createdAt** (string) (required): Creation timestamp (example: "2025-03-26T22:35:46Z") - **updatedAt** (string) (required): Last update timestamp (example: "2025-03-26T22:35:46Z") - **priority** (string) (required): User indicated priority for the solution (fractional-indexing string) (example: "a0") - **prd** (string) (required): Product Requirements Document content for the solution (example: "Objective: Help users easily create...") - **horizon** (string (now|next|later)): Time horizon for the solution (example: "now") ("now"|"next"|"later") - **opportunities** (array (Opportunity)) (required) Array items: - **id** (string (uuid)) (required): Unique identifier for the opportunity (example: "f5d8df32-60b4-417a-8b83-8d4dcb4e88e1") - **read** (boolean) (required): Whether the opportunity has been read (example: false) - **status** (string (New|Solved|Planned|InProgress)) (required): Current status of the opportunity (example: "New") ("New"|"Solved"|"Planned"|"InProgress") - **title** (string) (required): Title of the opportunity (example: "Improve Customer Onboarding Experience") - **description** (string) (required): Description of the opportunity (example: "Streamline the initial user setup process to reduce drop-offs") - **solutionsGeneratingState** (string (generating|generated|initial|error)) (required): Current state of solution generation (example: "initial") ("generating"|"generated"|"initial"|"error") - **createdBy** (string (user|generated)) (required): How the opportunity was created (example: "user") ("user"|"generated") - **hideContent** (boolean) (required): Whether the opportunity content should be hidden (example: false) - **ownerId** (string): ID of the opportunity owner (example: "d4e71c2b-a498-42af-b7f5-69de06a0d7c4") - **createdAt** (string) (required): Creation timestamp (example: "2023-01-01T00:00:00.000Z") - **updatedAt** (string) (required): Last update timestamp (example: "2023-01-01T00:00:00.000Z") - **insights** (array (Insight)) (required) Array items: - **id** (string (uuid)) (required): Unique identifier for the insight (example: "d231fe70-9585-4657-9c4e-6b431bbc1b6a") - **type** (string (Feedback|Bug|FeatureRequest)) (required): Type of insight (example: "Feedback") ("Feedback"|"Bug"|"FeatureRequest") - **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") - **seen** (boolean) (required): Whether the insight has been seen (example: false) - **hideContent** (boolean) (required): Whether the insight content should be hidden (example: false) - **ownerId** (string): ID of the insight owner (example: "d4e71c2b-a498-42af-b7f5-69de06a0d7c4") - **strengthScore** (number): Wilson score + corroboration score (0-1) (example: 0.75) - **momentumScore** (number): Recency and burst detection score (example: 0.5) - **combinedScore** (number): Weighted composite of strength and momentum scores (example: 0.65) - **lastScoreCalculatedAt** (string (date-time)): ISO timestamp of last score calculation (example: "2025-03-26T22:35:46Z") - **topicEmbeddings** (array (number)): BERT embeddings for topic modeling (example: [0.1,-0.2,0.3]) - **createdAt** (string) (required): Creation timestamp (example: "2025-03-26T22:35:46Z") - **updatedAt** (string) (required): Last update timestamp (example: "2025-03-26T22:35:46Z") - **outcomes** (array (Outcome)) (required) Array items: - **id** (string (uuid)) (required): Unique identifier for the outcome (example: "7b9e5d2c-f314-48a9-be56-9843a2f6c019") - **title** (string) (required): Title of the outcome (example: "Increase User Engagement") - **description** (string) (required): Detailed description of the outcome (example: "We aim to increase daily active users by 25% in Q3") - **priority** (number) (required): Priority level of the outcome (example: 1) - **trend** (number): Trend indicator for the outcome (example: 0) - **analyticEvents** (array (string)): List of analytic events associated with the outcome (example: ["event1","event2"]) - **hideContent** (boolean) (required): Whether the outcome is hidden (example: false) - **ownerId** (string): ID of the owner of the outcome (example: "7b9e5d2c-f314-48a9-be56-9843a2f6c019") - **createdAt** (string) (required): Timestamp of when the outcome was created (example: "2023-01-01T00:00:00.000Z") - **updatedAt** (string) (required): Timestamp of when the outcome was last updated (example: "2023-01-01T00:00:00.000Z") #### 401 - Unauthorized - Authentication required Unauthorized - Authentication required #### 403 - Forbidden - Insufficient permissions Forbidden - Insufficient permissions #### 404 - Solution not found Solution not found ### Example Usage ```bash curl -X GET "https://api.meetsquad.ai/organisations/{orgId}/workspaces/{workspaceId}/solutions/{solutionId}?relationships=string" ``` ``` -------------------------------- ### Schema: OnboardingV2Payload Source: https://api.meetsquad.ai/openapi.json Request schema for one-shot onboarding ```markdown ## Schema: OnboardingV2Payload Request schema for one-shot onboarding **Type:** object - **text** (string) (required): Text input describing the business or product (example: "A technology company focused on AI solutions for enterprise customers") - **knowledgeIds** (array (string (uuid))) (required): Array of knowledge entity IDs to process (example: ["a5f3c6e1-9d20-4f7b-8e31-d09a2b63c184","b7e2d5a9-3c18-4e6f-9a42-f8d1c7b5e3a2"]) - **newProduct** (boolean): Flag indicating if this is a new product (optional) (example: true) ``` -------------------------------- ### GET /organisations/{orgId} Source: https://api.meetsquad.ai/openapi.json Retrieves a specific organisation by ID ```markdown ### Parameters - **orgId** (string, path, required): Organization ID ### Responses #### 200 - Success - **data** (object) (required): Organisation data - **id** (string (uuid)) (required) - **name** (string) (required): Name of the organisation (example: "Acme Corporation") - **stripeCustomerId** (string): Stripe customer ID for billing (example: "cus_1234567890") - **homepageUrl** (string,null): URL to the organisation's homepage (example: "https://acme.example.com") - **logoUrl** (string,null): URL to the organisation's logo (example: "https://acme.example.com/logo.png") - **createdAt** (string) (required): Creation timestamp (example: "2025-03-26T22:35:46Z") - **accountType** (string (HOBBY|PROFESSIONAL|TEAM)) (required) ("HOBBY"|"PROFESSIONAL"|"TEAM") - **billingCycleStartDate** (string) (required): The start date of the current billing cycle. (example: "2025-03-26T22:35:46Z") - **billingCycleFlexCreditAllowance** (number) (required): Number of flex credits available at the start of the current billing cycle. (example: 100000) - **updatedAt** (string) (required): Last update timestamp (example: "2025-03-26T22:35:46Z") - **status** (string (ACTIVE|ARCHIVED)) (required): Status of the organisation (example: "ACTIVE") ("ACTIVE"|"ARCHIVED") - **unprocessedFeedbackCount** (number) (required): Number of unprocessed insight items (example: 123) #### 401 - Unauthorized - Authentication required - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "UNAUTHORISED_ERROR") - **description** (string) (required): Human-readable error description (example: "User is unauthenticated") #### 403 - Forbidden - Insufficient permissions - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "UNAUTHORISED_ERROR") - **description** (string) (required): Human-readable error description (example: "User is unauthorised") #### 404 - Organisation not found - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "NOT_FOUND") - **description** (string) (required): Human-readable error description (example: "The requested resource was not found") #### 500 - Internal Server Error - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "INTERNAL_SERVER_ERROR") - **description** (string) (required): Human-readable error description (example: "An unexpected error occurred on the server") ### Example Usage ```bash curl -X GET "https://api.meetsquad.ai/organisations/{orgId}" ``` ``` -------------------------------- ### Schema: OnboardingPayload Source: https://api.meetsquad.ai/openapi.json Request schema for onboarding ```markdown ## Schema: OnboardingPayload Request schema for onboarding **Type:** object - **name** (string) (required): Name of the organization to create (example: "Acme Corporation") - **description** (string) (required): Description of the organization for generating workspace and outcomes (example: "A technology company focused on AI solutions for enterprise customers") ``` -------------------------------- ### GET /organisations Source: https://api.meetsquad.ai/openapi.json Lists all organisations accessible to the authenticated user ```markdown ### Responses #### 200 - Success - **data** (array (object)) (required): Array of organisations Array items: - **id** (string (uuid)) (required) - **name** (string) (required): Name of the organisation (example: "Acme Corporation") - **stripeCustomerId** (string): Stripe customer ID for billing (example: "cus_1234567890") - **homepageUrl** (string,null): URL to the organisation's homepage (example: "https://acme.example.com") - **logoUrl** (string,null): URL to the organisation's logo (example: "https://acme.example.com/logo.png") - **createdAt** (string) (required): Creation timestamp (example: "2025-03-26T22:35:46Z") - **accountType** (string (HOBBY|PROFESSIONAL|TEAM)) (required) ("HOBBY"|"PROFESSIONAL"|"TEAM") - **billingCycleStartDate** (string) (required): The start date of the current billing cycle. (example: "2025-03-26T22:35:46Z") - **billingCycleFlexCreditAllowance** (number) (required): Number of flex credits available at the start of the current billing cycle. (example: 100000) - **updatedAt** (string) (required): Last update timestamp (example: "2025-03-26T22:35:46Z") - **status** (string (ACTIVE|ARCHIVED)) (required): Status of the organisation (example: "ACTIVE") ("ACTIVE"|"ARCHIVED") - **unprocessedFeedbackCount** (number) (required): Number of unprocessed insight items (example: 123) #### 401 - Unauthorized - Authentication required - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "UNAUTHORISED_ERROR") - **description** (string) (required): Human-readable error description (example: "User is unauthenticated") #### 403 - Forbidden - Insufficient permissions - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "UNAUTHORISED_ERROR") - **description** (string) (required): Human-readable error description (example: "User is unauthorised") #### 500 - Internal Server Error - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "INTERNAL_SERVER_ERROR") - **description** (string) (required): Human-readable error description (example: "An unexpected error occurred on the server") ### Example Usage ```bash curl -X GET "https://api.meetsquad.ai/organisations" ``` ``` -------------------------------- ### GET /organisations/{orgId}/workspaces Source: https://api.meetsquad.ai/openapi.json Lists all workspaces for the specified organization ```markdown ### Parameters - **orgId** (string, path, required): Organization ID ### Responses #### 200 - Success - **data** (array (Workspace)) (required): Array of workspaces Array items: - **id** (string (uuid)) (required): ID of the workspace (example: "c0e195d9-b918-4a3a-bd8b-f730361d044f") - **name** (string) (required): Name of the workspace (example: "Product Development") - **homepageUrl** (string,null): URL to the workspace's homepage (example: "https://product.example.com") - **logoUrl** (string,null): URL to the workspace's logo (example: "https://product.example.com/logo.png") - **missionStatement** (string) (required): Mission statement for the workspace (example: "Develop innovative products that solve real customer problems") - **description** (string): Detailed description of the workspace (example: "This workspace focuses on our core product development initiatives, including roadmap planning, feature development, and product improvements.") - **createdAt** (string) (required): Creation timestamp (example: "2025-03-26T22:35:46Z") - **updatedAt** (string) (required): Last update timestamp (example: "2025-03-26T22:35:46Z") - **status** (string (Initializing|OnboardingDeepResearch|OnboardingConsiderWorkspace|OnboardingConsiderOpportunities|OnboardingConsiderOpportunitiesToOutcomes|OnboardingConsiderSolutionGeneration|OnboardingConsiderSolutionsToBuild|OnboardingSelectSolutionsToBuild|OnboardingMapSolutionsToRoadmap|Active|Inactive)) (required): Status of the workspace (example: "Initializing") ("Initializing"|"OnboardingDeepResearch"|"OnboardingConsiderWorkspace"|"OnboardingConsiderOpportunities"|"OnboardingConsiderOpportunitiesToOutcomes"|"OnboardingConsiderSolutionGeneration"|"OnboardingConsiderSolutionsToBuild"|"OnboardingSelectSolutionsToBuild"|"OnboardingMapSolutionsToRoadmap"|"Active"|"Inactive") #### 401 - Unauthorized - Authentication required - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "UNAUTHORISED_ERROR") - **description** (string) (required): Human-readable error description (example: "User is unauthenticated") #### 403 - Forbidden - Insufficient permissions - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "UNAUTHORISED_ERROR") - **description** (string) (required): Human-readable error description (example: "User is unauthorised") #### 500 - Internal Server Error - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "INTERNAL_SERVER_ERROR") - **description** (string) (required): Human-readable error description (example: "An unexpected error occurred on the server") ### Example Usage ```bash curl -X GET "https://api.meetsquad.ai/organisations/{orgId}/workspaces" ``` ``` -------------------------------- ### Schema: CreateSolutionPayload Source: https://api.meetsquad.ai/openapi.json Request schema for creating a solution ```markdown ## Schema: CreateSolutionPayload Request schema for creating a solution **Type:** object - **id** (string (uuid)) - **systemPrompt** (string) - **aiProcessingState** (string (INITIAL|PROCESSING|FINISHED|ERROR)) ("INITIAL"|"PROCESSING"|"FINISHED"|"ERROR") - **refinementLog** (array (object)) Array items: - **id** (string (uuid)) (required) - **role** (string (user|assistant)) (required) ("user"|"assistant") - **content** (string) (required) - **title** (string) (required): Title of the solution (example: "Implement Single Sign-On") - **description** (string) (required): Description of the solution (example: "Integrate with OAuth providers to simplify user login experience") - **status** (string (Backlog|New|Planned|InDevelopment|Complete|Cancelled|Live)): Solution status (example: "Backlog") ("Backlog"|"New"|"Planned"|"InDevelopment"|"Complete"|"Cancelled"|"Live") - **pros** (array (string)) - **cons** (array (string)) - **createdBy** (string (user|generated)) (required): How the solution was created (example: "generated") ("user"|"generated") - **ownerId** (string) - **prd** (string) (required): Product Requirements Document content for the solution (example: "Objective: Help users easily create...") - **opportunityIds** (array (string)) - **horizon** (string (now|next|later)): Solution horizon (example: "now") ("now"|"next"|"later") ``` -------------------------------- ### GET /org/{orgId}/workspace/{workspaceId}/integration Source: https://api.meetsquad.ai/openapi.json Returns all integrations for the workspace ```markdown ### Parameters - **orgId** (string, path, required): Organization ID - **workspaceId** (string, path, required): Workspace ID ### Responses #### 200 - List of integrations - **data** (array (Integration)) (required) Array items: - **id** (number) (required) - **integrationId** (string) (required) - **workspaceId** (string) (required) - **organisationId** (string) (required) - **config** (object) (required): Notion integration configuration in API response (sanitized) - **active** (boolean) (required): Whether the Notion integration is active (example: false) - **created_by** (string) (required): User ID who created this integration (example: "d4e71c2b-a498-42af-b7f5-69de06a0d7c4") - **last_synced_at** (string,null): Last time data was synced from Notion (example: "2025-03-26T22:35:46Z") - **createdAt** (string (date-time)) (required) - **updatedAt** (string (date-time)) (required) #### 401 - Unauthorized Unauthorized ### Example Usage ```bash curl -X GET "https://api.meetsquad.ai/org/{orgId}/workspace/{workspaceId}/integration" ``` ``` -------------------------------- ### Schema: OnboardingResponse Source: https://api.meetsquad.ai/openapi.json Response schema for onboarding ```markdown ## Schema: OnboardingResponse Response schema for onboarding **Type:** object - **data** (object) (required) - **workspace** (object) (required): Workspace data - **id** (string (uuid)) (required): ID of the workspace (example: "c0e195d9-b918-4a3a-bd8b-f730361d044f") - **name** (string) (required): Name of the workspace (example: "Product Development") - **homepageUrl** (string,null): URL to the workspace's homepage (example: "https://product.example.com") - **logoUrl** (string,null): URL to the workspace's logo (example: "https://product.example.com/logo.png") - **missionStatement** (string) (required): Mission statement for the workspace (example: "Develop innovative products that solve real customer problems") - **description** (string): Detailed description of the workspace (example: "This workspace focuses on our core product development initiatives, including roadmap planning, feature development, and product improvements.") - **createdAt** (string) (required): Creation timestamp (example: "2025-03-26T22:35:46Z") - **updatedAt** (string) (required): Last update timestamp (example: "2025-03-26T22:35:46Z") - **status** (string (Initializing|OnboardingDeepResearch|OnboardingConsiderWorkspace|OnboardingConsiderOpportunities|OnboardingConsiderOpportunitiesToOutcomes|OnboardingConsiderSolutionGeneration|OnboardingConsiderSolutionsToBuild|OnboardingSelectSolutionsToBuild|OnboardingMapSolutionsToRoadmap|Active|Inactive)) (required): Status of the workspace (example: "Initializing") ("Initializing"|"OnboardingDeepResearch"|"OnboardingConsiderWorkspace"|"OnboardingConsiderOpportunities"|"OnboardingConsiderOpportunitiesToOutcomes"|"OnboardingConsiderSolutionGeneration"|"OnboardingConsiderSolutionsToBuild"|"OnboardingSelectSolutionsToBuild"|"OnboardingMapSolutionsToRoadmap"|"Active"|"Inactive") - **outcomes** (array (Outcome)) (required): Array of outcomes Array items: - **id** (string (uuid)) (required): Unique identifier for the outcome (example: "7b9e5d2c-f314-48a9-be56-9843a2f6c019") - **title** (string) (required): Title of the outcome (example: "Increase User Engagement") - **description** (string) (required): Detailed description of the outcome (example: "We aim to increase daily active users by 25% in Q3") - **priority** (number) (required): Priority level of the outcome (example: 1) - **trend** (number): Trend indicator for the outcome (example: 0) - **analyticEvents** (array (string)): List of analytic events associated with the outcome (example: ["event1","event2"]) - **hideContent** (boolean) (required): Whether the outcome is hidden (example: false) - **ownerId** (string): ID of the owner of the outcome (example: "7b9e5d2c-f314-48a9-be56-9843a2f6c019") - **createdAt** (string) (required): Timestamp of when the outcome was created (example: "2023-01-01T00:00:00.000Z") - **updatedAt** (string) (required): Timestamp of when the outcome was last updated (example: "2023-01-01T00:00:00.000Z") - **organisation** (object) (required) - **id** (string (uuid)) (required): Unique identifier for the organization (example: "a5f3c6e1-9d20-4f7b-8e31-d09a2b63c184") - **name** (string) (required): Name of the organization (example: "Acme Corporation") ``` -------------------------------- ### GET /organisations/{orgId}/workspaces/{workspaceId} Source: https://api.meetsquad.ai/openapi.json Retrieves a specific workspace by ID ```markdown ### Parameters - **orgId** (string, path, required): Organization ID - **workspaceId** (string, path, required): Workspace ID ### Responses #### 200 - Success - **data** (object) (required): Workspace data - **id** (string (uuid)) (required): ID of the workspace (example: "c0e195d9-b918-4a3a-bd8b-f730361d044f") - **name** (string) (required): Name of the workspace (example: "Product Development") - **homepageUrl** (string,null): URL to the workspace's homepage (example: "https://product.example.com") - **logoUrl** (string,null): URL to the workspace's logo (example: "https://product.example.com/logo.png") - **missionStatement** (string) (required): Mission statement for the workspace (example: "Develop innovative products that solve real customer problems") - **description** (string): Detailed description of the workspace (example: "This workspace focuses on our core product development initiatives, including roadmap planning, feature development, and product improvements.") - **createdAt** (string) (required): Creation timestamp (example: "2025-03-26T22:35:46Z") - **updatedAt** (string) (required): Last update timestamp (example: "2025-03-26T22:35:46Z") - **status** (string (Initializing|OnboardingDeepResearch|OnboardingConsiderWorkspace|OnboardingConsiderOpportunities|OnboardingConsiderOpportunitiesToOutcomes|OnboardingConsiderSolutionGeneration|OnboardingConsiderSolutionsToBuild|OnboardingSelectSolutionsToBuild|OnboardingMapSolutionsToRoadmap|Active|Inactive)) (required): Status of the workspace (example: "Initializing") ("Initializing"|"OnboardingDeepResearch"|"OnboardingConsiderWorkspace"|"OnboardingConsiderOpportunities"|"OnboardingConsiderOpportunitiesToOutcomes"|"OnboardingConsiderSolutionGeneration"|"OnboardingConsiderSolutionsToBuild"|"OnboardingSelectSolutionsToBuild"|"OnboardingMapSolutionsToRoadmap"|"Active"|"Inactive") #### 401 - Unauthorized - Authentication required - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "UNAUTHORISED_ERROR") - **description** (string) (required): Human-readable error description (example: "User is unauthenticated") #### 403 - Forbidden - Insufficient permissions - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "UNAUTHORISED_ERROR") - **description** (string) (required): Human-readable error description (example: "User is unauthorised") #### 404 - Workspace not found - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "NOT_FOUND") - **description** (string) (required): Human-readable error description (example: "The requested resource was not found") #### 500 - Internal Server Error - **error** (object) (required) - **code** (string) (required): Error code identifier (example: "INTERNAL_SERVER_ERROR") - **description** (string) (required): Human-readable error description (example: "An unexpected error occurred on the server") ### Example Usage ```bash curl -X GET "https://api.meetsquad.ai/organisations/{orgId}/workspaces/{workspaceId}" ``` ``` -------------------------------- ### POST /organisations/{orgId}/workspaces/{workspaceId}/solutions Source: https://api.meetsquad.ai/openapi.json Creates a new solution in the specified workspace ```markdown ### Parameters - **orgId** (string, path, required): Organization ID - **workspaceId** (string, path, required): Workspace ID ### Request Body **Content-Type:** application/json - **id** (string (uuid)) - **systemPrompt** (string) - **aiProcessingState** (string (INITIAL|PROCESSING|FINISHED|ERROR)) ("INITIAL"|"PROCESSING"|"FINISHED"|"ERROR") - **refinementLog** (array (object)) Array items: - **id** (string (uuid)) (required) - **role** (string (user|assistant)) (required) ("user"|"assistant") - **content** (string) (required) - **title** (string) (required): Title of the solution (example: "Implement Single Sign-On") - **description** (string) (required): Description of the solution (example: "Integrate with OAuth providers to simplify user login experience") - **status** (string (Backlog|New|Planned|InDevelopment|Complete|Cancelled|Live)): Solution status (example: "Backlog") ("Backlog"|"New"|"Planned"|"InDevelopment"|"Complete"|"Cancelled"|"Live") - **pros** (array (string)) - **cons** (array (string)) - **createdBy** (string (user|generated)) (required): How the solution was created (example: "generated") ("user"|"generated") - **ownerId** (string) - **prd** (string) (required): Product Requirements Document content for the solution (example: "Objective: Help users easily create...") - **opportunityIds** (array (string)) - **horizon** (string (now|next|later)): Solution horizon (example: "now") ("now"|"next"|"later") ### Responses #### 200 - Solution created successfully - **data** (object) (required): Solution with relationships - **id** (string (uuid)) (required) - **systemPrompt** (string): System prompt used to generate the requirement (example: "Hello") - **aiProcessingState** (string (INITIAL|PROCESSING|FINISHED|ERROR)) (required): Current state of AI processing (example: "FINISHED") ("INITIAL"|"PROCESSING"|"FINISHED"|"ERROR") - **refinementLog** (array (object)) (required): Log of refinements made to the requirement (example: []) Array items: - **id** (string (uuid)) (required): Unique identifier for the log entry (example: "96dafa28-1e01-4ba4-a92b-babb8b792823") - **role** (string (user|assistant)) (required): Role of the entity making the log entry (example: "assistant") ("user"|"assistant") - **content** (string) (required): Content of the log entry (example: "Initial requirement") - **title** (string) (required): Title of the solution (example: "Implement Single Sign-On") - **description** (string) (required): Description of the solution (example: "Integrate with OAuth providers to simplify user login experience") - **status** (string (Backlog|New|Planned|InDevelopment|Complete|Cancelled|Live)) (required): Solution status (example: "Backlog") ("Backlog"|"New"|"Planned"|"InDevelopment"|"Complete"|"Cancelled"|"Live") - **pros** (array (string)) (required): List of pros/advantages for this solution (example: ["Improved security","Simplified login flow","Reduced password reset requests"]) - **cons** (array (string)) (required): List of cons/disadvantages for this solution (example: ["Requires integration with external providers","May add complexity to registration"]) - **hideContent** (boolean) (required): Whether the solution content should be hidden (example: false) - **createdBy** (string (user|generated)) (required): How the solution was created (example: "generated") ("user"|"generated") - **ownerId** (string): ID of the solution owner (example: "d4e71c2b-a498-42af-b7f5-69de06a0d7c4") - **createdAt** (string) (required): Creation timestamp (example: "2025-03-26T22:35:46Z") - **updatedAt** (string) (required): Last update timestamp (example: "2025-03-26T22:35:46Z") - **priority** (string) (required): User indicated priority for the solution (fractional-indexing string) (example: "a0") - **prd** (string) (required): Product Requirements Document content for the solution (example: "Objective: Help users easily create...") - **horizon** (string (now|next|later)): Time horizon for the solution (example: "now") ("now"|"next"|"later") - **opportunities** (array (Opportunity)) (required) Array items: - **id** (string (uuid)) (required): Unique identifier for the opportunity (example: "f5d8df32-60b4-417a-8b83-8d4dcb4e88e1") - **read** (boolean) (required): Whether the opportunity has been read (example: false) - **status** (string (New|Solved|Planned|InProgress)) (required): Current status of the opportunity (example: "New") ("New"|"Solved"|"Planned"|"InProgress") - **title** (string) (required): Title of the opportunity (example: "Improve Customer Onboarding Experience") - **description** (string) (required): Description of the opportunity (example: "Streamline the initial user setup process to reduce drop-offs") - **solutionsGeneratingState** (string (generating|generated|initial|error)) (required): Current state of solution generation (example: "initial") ("generating"|"generated"|"initial"|"error") - **createdBy** (string (user|generated)) (required): How the opportunity was created (example: "user") ("user"|"generated") - **hideContent** (boolean) (required): Whether the opportunity content should be hidden (example: false) - **ownerId** (string): ID of the opportunity owner (example: "d4e71c2b-a498-42af-b7f5-69de06a0d7c4") - **createdAt** (string) (required): Creation timestamp (example: "2023-01-01T00:00:00.000Z") - **updatedAt** (string) (required): Last update timestamp (example: "2023-01-01T00:00:00.000Z") - **insights** (array (Insight)) (required) Array items: - **id** (string (uuid)) (required): Unique identifier for the insight (example: "d231fe70-9585-4657-9c4e-6b431bbc1b6a") - **type** (string (Feedback|Bug|FeatureRequest)) (required): Type of insight (example: "Feedback") ("Feedback"|"Bug"|"FeatureRequest") - **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") - **seen** (boolean) (required): Whether the insight has been seen (example: false) - **hideContent** (boolean) (required): Whether the insight content should be hidden (example: false) - **ownerId** (string): ID of the insight owner (example: "d4e71c2b-a498-42af-b7f5-69de06a0d7c4") - **strengthScore** (number): Wilson score + corroboration score (0-1) (example: 0.75) - **momentumScore** (number): Recency and burst detection score (example: 0.5) - **combinedScore** (number): Weighted composite of strength and momentum scores (example: 0.65) - **lastScoreCalculatedAt** (string (date-time)): ISO timestamp of last score calculation (example: "2025-03-26T22:35:46Z") - **topicEmbeddings** (array (number)): BERT embeddings for topic modeling (example: [0.1,-0.2,0.3]) - **createdAt** (string) (required): Creation timestamp (example: "2025-03-26T22:35:46Z") - **updatedAt** (string) (required): Last update timestamp (example: "2025-03-26T22:35:46Z") - **outcomes** (array (Outcome)) (required) Array items: - **id** (string (uuid)) (required): Unique identifier for the outcome (example: "7b9e5d2c-f314-48a9-be56-9843a2f6c019") - **title** (string) (required): Title of the outcome (example: "Increase User Engagement") - **description** (string) (required): Detailed description of the outcome (example: "We aim to increase daily active users by 25% in Q3") - **priority** (number) (required): Priority level of the outcome (example: 1) - **trend** (number): Trend indicator for the outcome (example: 0) - **analyticEvents** (array (string)): List of analytic events associated with the outcome (example: ["event1","event2"]) - **hideContent** (boolean) (required): Whether the outcome is hidden (example: false) - **ownerId** (string): ID of the owner of the outcome (example: "7b9e5d2c-f314-48a9-be56-9843a2f6c019") - **createdAt** (string) (required): Timestamp of when the outcome was created (example: "2023-01-01T00:00:00.000Z") - **updatedAt** (string) (required): Timestamp of when the outcome was last updated (example: "2023-01-01T00:00:00.000Z") #### 400 - Bad Request - Invalid input Bad Request - Invalid input #### 401 - Unauthorized - Authentication required Unauthorized - Authentication required #### 403 - Forbidden - Insufficient permissions Forbidden - Insufficient permissions ### Example Usage ```bash curl -X POST "https://api.meetsquad.ai/organisations/{orgId}/workspaces/{workspaceId}/solutions" \ -H "Content-Type: application/json" \ -d '{ "id": "string", "systemPrompt": "string", "aiProcessingState": "INITIAL", "refinementLog": [ { "id": "string", "role": "user", "content": "string" } ], "title": "Implement Single Sign-On", "description": "Integrate with OAuth providers to simplify user login experience", "status": "Backlog", "pros": [ "string" ], "cons": [ "string" ], "createdBy": "generated", "ownerId": "string", "prd": "Objective: Help users easily create...", "opportunityIds": [ "string" ], "horizon": "now" }' ``` ```