> ## 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.

# Attach an artifact to a conversation

> Attach a KB page, table, or workflow as context for the conversation.



## OpenAPI

````yaml /openapi/ai-brain.yaml post /ai-chat/conversations/{id}/artifacts
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/{id}/artifacts:
    post:
      tags:
        - Artifacts
      summary: Attach an artifact to a conversation
      description: Attach a KB page, table, or workflow as context for the conversation.
      operationId: createConversationArtifact
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - source_type
                - source_id
              properties:
                source_type:
                  type: string
                  enum:
                    - kb
                    - kb_article
                    - workflow
                    - table
                source_id:
                  type: string
                title:
                  type: string
      responses:
        '201':
          description: Artifact attached
          content:
            application/json:
              schema:
                type: object
                properties:
                  artifact:
                    $ref: '#/components/schemas/ConversationArtifact'
        '409':
          description: Artifact already attached
components:
  schemas:
    ConversationArtifact:
      type: object
      properties:
        id:
          type: string
        conversation_id:
          type: string
        source_type:
          type: string
          enum:
            - kb
            - kb_article
            - workflow
            - table
        source_id:
          type: string
        title:
          type: string
          nullable: true
        created_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.