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

# Leave an internal note on a conversation. Notes are not messages: they
are never sent to the contact and are only included in the AI's context
when marked AiVisible.



## OpenAPI

````yaml https://megastream25-api.closebot.com/swagger/v1/swagger.json post /lead/{leadId}/note
openapi: 3.0.4
info:
  title: CloseBot API
  version: v1
servers:
  - url: https://api.closebot.com
    description: CloseBot API Endpoint
security:
  - Key: []
tags:
  - name: Account
  - name: AccountNotification
  - name: Agency
  - name: Analytics
  - name: Billing
  - name: Bot
  - name: BotMetric
  - name: BotSourceVariable
  - name: BotTemplate
  - name: BotTesting
  - name: Dashboard
  - name: Hierarchy
  - name: Lead
  - name: Leaderboard
  - name: Library
  - name: LiveDemo
  - name: Notification
  - name: Persona
  - name: Report
  - name: SmartFAQ
  - name: Source
  - name: SourceChannel
  - name: Webhook
paths:
  /lead/{leadId}/note:
    post:
      tags:
        - Lead
      summary: |-
        Leave an internal note on a conversation. Notes are not messages: they
        are never sent to the contact and are only included in the AI's context
        when marked AiVisible.
      parameters:
        - name: leadId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateNoteInputDto'
          text/json:
            schema:
              $ref: '#/components/schemas/CreateNoteInputDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/CreateNoteInputDto'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/NoteResultDto'
            application/json:
              schema:
                $ref: '#/components/schemas/NoteResultDto'
            text/json:
              schema:
                $ref: '#/components/schemas/NoteResultDto'
components:
  schemas:
    CreateNoteInputDto:
      required:
        - aiVisible
        - body
      type: object
      properties:
        body:
          type: string
          nullable: true
        aiVisible:
          type: boolean
          description: Whether the AI agent can see this note in its conversation context.
        mentionedAccountIds:
          type: array
          items:
            type: string
          description: |-
            Account IDs of users @-mentioned in the body. Team members are
            always allowed; clients only if they have access to the lead's
            source. Anything else is dropped silently.
          nullable: true
      additionalProperties: false
    NoteResultDto:
      required:
        - aiVisible
        - noteId
      type: object
      properties:
        noteId:
          type: string
          nullable: true
        aiVisible:
          type: boolean
      additionalProperties: false
  securitySchemes:
    Key:
      type: apiKey
      description: CloseBot API Key Authorization
      name: X-CB-KEY
      in: header

````