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

# applyNoteOperation

> to resolve conflicts with concurrent edits. The operation is transformed against any
concurrent operations that occurred after the client's last known state, ensuring
convergence across all clients. Tracks conflicts and returns the transformed operation
along with the new document version.



## OpenAPI

````yaml api-reference/convex-openapi.yaml post /api/run/notes/mutations/applyNoteOperation
openapi: 3.0.3
info:
  title: Connvo Convex API
  version: 1.0.0
  description: >-
    HTTP interface for Connvo's Convex backend, exposing vetted query, mutation,
    and action endpoints.
servers:
  - url: https://Connvo-dev.convex.cloud
    description: Dev Convex deployment
  - url: https://Connvo-staging.convex.cloud
    description: Staging Convex deployment
  - url: https://Connvo-prod.convex.cloud
    description: Prod Convex deployment
security:
  - bearerAuth: []
tags:
  - name: Users
    description: Identity, profile, and authentication operations for Connvo users.
  - name: Meetings
    description: Scheduling, managing, and retrieving meeting data.
  - name: Transcripts
    description: Endpoints for accessing call transcripts and transcription controls.
  - name: Insights
    description: AI-generated insights, summaries, and analytics derived from meetings.
  - name: Prompts
    description: Prompt management and AI conversation guidance.
  - name: Notes
    description: Collaborative meeting notes and follow-up documentation.
  - name: WebRTC
    description: Real-time communication, session signalling, and media utilities.
  - name: System
    description: General system endpoints such as health checks and diagnostics.
paths:
  /api/run/notes/mutations/applyNoteOperation:
    post:
      tags:
        - Notes
      summary: applyNoteOperation
      description: >-
        to resolve conflicts with concurrent edits. The operation is transformed
        against any

        concurrent operations that occurred after the client's last known state,
        ensuring

        convergence across all clients. Tracks conflicts and returns the
        transformed operation

        along with the new document version.
      operationId: postApiRunNotesMutationsApplyNoteOperation
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Request_notes.mutations.applyNoteOperation'
            example:
              args:
                meetingId: meeting_123example
                operation:
                  type: insert
                  position: 42
                  content: |
                    Action items:
                    - Follow up on Q4 goals
                clientSequence: 15
                expectedVersion: 8
        required: true
      responses:
        '200':
          description: Convex executed your request and returned a result
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Response_notes.mutations.applyNoteOperation
              example:
                status: success
                errorMessage: ''
                errorData: {}
                value:
                  success: true
                  serverSequence: 16
                  transformedOperation:
                    type: insert
                    position: 45
                    content: |
                      Action items:
                      - Follow up on Q4 goals
                  newVersion: 9
                  conflicts: []
        '400':
          description: Failed operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FailedResponse'
        '500':
          description: Convex Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FailedResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    Request_notes.mutations.applyNoteOperation:
      type: object
      required:
        - args
      properties:
        args:
          type: object
          required:
            - clientSequence
            - meetingId
            - operation
          properties:
            clientSequence:
              type: number
            expectedVersion:
              type: number
            meetingId:
              type: string
              description: ID from table "meetings"
            operation:
              type: object
              required:
                - position
                - type
              properties:
                content:
                  type: string
                length:
                  type: number
                position:
                  type: number
                type:
                  oneOf:
                    - type: string
                      enum:
                        - insert
                    - type: string
                      enum:
                        - delete
                    - type: string
                      enum:
                        - retain
    Response_notes.mutations.applyNoteOperation:
      type: object
      required:
        - status
      properties:
        status:
          type: string
          enum:
            - success
            - error
        errorMessage:
          type: string
        errorData:
          type: object
        value:
          type: object
          required:
            - conflicts
            - newVersion
            - serverSequence
            - success
            - transformedOperation
          properties:
            conflicts:
              type: array
              items:
                type: string
            newVersion:
              type: number
            serverSequence:
              type: number
            success:
              type: boolean
            transformedOperation:
              type: object
              required:
                - position
                - type
              properties:
                content:
                  type: string
                length:
                  type: number
                position:
                  type: number
                type:
                  oneOf:
                    - type: string
                      enum:
                        - insert
                    - type: string
                      enum:
                        - delete
                    - type: string
                      enum:
                        - retain
    FailedResponse:
      type: object
      properties: {}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Standard user authentication token issued via WorkOS. Provide as
        `Authorization: Bearer <user-token>`.

````