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

# Create a conversation



## OpenAPI

````yaml /openapi/ai-brain.yaml post /ai-chat/conversations
openapi: 3.1.0
info:
  title: Connie AI & Brain API
  version: 1.0.0
  description: >
    API for the AI & Brain module — the orchestration layer powering all AI
    features: the main conversational AI (Brain), AI chat conversations, browser
    automation tasks, agent identity management, and AI usage tracking.

    The Brain is the core AI engine. It accepts messages, orchestrates tool
    calls via Temporal workflows, and streams responses back. It powers the AI
    copilot across the entire product.
servers:
  - url: https://connie.ai/api
    description: Production
security:
  - cookieAuth: []
tags:
  - name: Brain
    description: Core AI engine — conversation, streaming, and workflow orchestration
  - name: Brain Plans
    description: Agent planning context (goal, steps, status)
  - name: AI Chat
    description: Persistent conversation and message management
  - name: AI Chat Attachments
    description: File uploads for AI context
  - name: Browser Tasks
    description: AI-driven browser automation tasks
  - name: Artifacts
    description: KB, table, and workflow artifacts attached to conversations
  - name: Agent Identities
    description: Named AI agent configuration and tool assignments
  - name: AI Cache
    description: FAQ response caching
  - name: AI Usage
    description: Token usage statistics
paths:
  /ai-chat/conversations:
    post:
      tags:
        - AI Chat
      summary: Create a conversation
      operationId: createAiChatConversation
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - source
              properties:
                title:
                  type: string
                source:
                  type: string
                  enum:
                    - webapp
                    - extension
                workspace_id:
                  type: string
                  format: uuid
                metadata:
                  type: object
      responses:
        '201':
          description: Conversation created
          content:
            application/json:
              schema:
                type: object
                properties:
                  conversation:
                    $ref: '#/components/schemas/AiConversation'
components:
  schemas:
    AiConversation:
      type: object
      properties:
        id:
          type: string
        user_id:
          type: string
        workspace_id:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        source:
          type: string
          enum:
            - webapp
            - extension
        is_archived:
          type: boolean
        metadata:
          type: object
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: session

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.