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

# Create or update a transfer note



## OpenAPI

````yaml /api-reference/platform-api.json post /v2/transfers/enrichment/notes
openapi: 3.0.0
info:
  title: Range Platform API
  description: >-
    The Range Platform API for workspace management, counterparties, and
    operational tooling.
  version: 1.7.8
  contact: {}
servers:
  - url: https://api.range.org
    description: Range API Server
security:
  - Authorization: []
tags:
  - name: Counterparties
    description: Manage external entities, their addresses, bank accounts, and documents.
  - name: Transfer Enrichments
    description: Attach workspace-scoped notes and categories to transfers.
paths:
  /v2/transfers/enrichment/notes:
    post:
      tags:
        - Transfer Enrichments
      summary: Create or update a transfer note
      operationId: upsertNote
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpsertTxNoteDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TxNoteDto'
components:
  schemas:
    UpsertTxNoteDto:
      type: object
      properties:
        transferId:
          type: string
        note:
          type: string
          minLength: 1
          maxLength: 500
      required:
        - transferId
        - note
    TxNoteDto:
      type: object
      properties:
        workspaceId:
          type: string
        transferId:
          type: string
        note:
          type: string
        createdAt:
          type: string
        updatedAt:
          type: string
      required:
        - workspaceId
        - transferId
        - note
        - createdAt
        - updatedAt
  securitySchemes:
    Authorization:
      scheme: bearer
      bearerFormat: API Key
      description: 'Use Authorization: Bearer <api-key>'
      type: http

````