> ## Documentation Index
> Fetch the complete documentation index at: https://camelai.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate chat recommendations

> Generate intelligent recommendations for questions and insights based on connected data sources and optional conversation context. If thread_id is provided, recommendations will be contextual to the conversation. Otherwise, general starting point recommendations will be generated.



## OpenAPI

````yaml https://api.camelai.com/api/schema/ post /api/v1/recommendations
openapi: 3.0.3
info:
  title: camelAI API
  version: 1.0.0 (v1)
  description: API for camelAI - AI-powered data analytics platform
servers:
  - url: https://api.camelai.com
    description: camelAI API server
security: []
paths:
  /api/v1/recommendations:
    post:
      tags:
        - recommendations
      summary: Generate chat recommendations
      description: >-
        Generate intelligent recommendations for questions and insights based on
        connected data sources and optional conversation context. If thread_id
        is provided, recommendations will be contextual to the conversation.
        Otherwise, general starting point recommendations will be generated.
      operationId: recommendations_create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatRecommendationsRequest'
            examples:
              BasicRecommendationsWithoutThreadContext:
                value:
                  source_ids:
                    - 1
                    - 2
                summary: Basic recommendations without thread context
              ContextualRecommendationsWithThread:
                value:
                  source_ids:
                    - 1
                  thread_id: 123
                summary: Contextual recommendations with thread
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatRecommendationsResponse'
              examples:
                BasicRecommendationsWithoutThreadContext:
                  value:
                    source_ids:
                      - 1
                      - 2
                  summary: Basic recommendations without thread context
                ContextualRecommendationsWithThread:
                  value:
                    source_ids:
                      - 1
                    thread_id: 123
                  summary: Contextual recommendations with thread
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecommendationsErrorResponse'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecommendationsAccessDeniedResponse'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecommendationsNotFoundResponse'
          description: ''
      security:
        - ApiKeyAuth: []
        - {}
components:
  schemas:
    ChatRecommendationsRequest:
      type: object
      description: Serializer for chat recommendations request.
      properties:
        source_ids:
          type: array
          items:
            type: integer
          description: List of connection IDs to generate recommendations for
          minItems: 1
        thread_id:
          type: integer
          nullable: true
          description: Optional thread ID for contextual recommendations
    ChatRecommendationsResponse:
      type: object
      description: Serializer for chat recommendations response.
      properties:
        suggestions:
          type: array
          items:
            type: string
          description: List of recommendation suggestions
      required:
        - suggestions
    RecommendationsErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
        details:
          type: object
          additionalProperties: {}
          description: Additional error details
        hint:
          type: string
          description: Helpful hint for resolving the error
      required:
        - error
    RecommendationsAccessDeniedResponse:
      type: object
      properties:
        error:
          type: string
          description: Access denied message
        hint:
          type: string
          description: Helpful hint for resolving the access issue
      required:
        - error
    RecommendationsNotFoundResponse:
      type: object
      properties:
        error:
          type: string
          description: Not found error message
        hint:
          type: string
          description: Helpful hint for resolving the issue
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: API key authentication using Bearer scheme

````