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

# Update Conversion Notes

Attach free-form notes to an existing conversion. Notes are visible to network users in the Everflow UI and are returned on subsequent reads of the conversion record. Pass an empty string to clear existing notes.


## OpenAPI

````yaml openapi/reporting-conversions.yaml put /networks/reporting/conversions/{conversionId}/notes
openapi: 3.0.3
info:
  title: Everflow Network API - Conversion Reporting
  description: >
    Conversion reporting and management endpoints for the Everflow partner
    marketing platform. Search, retrieve, update, and create conversions. For
    more detail, see [Conversion
    Report](https://helpdesk.everflow.io/customer/conversion-report) in the Help
    Center.
  version: 1.0.0
servers:
  - description: Production Server
    url: https://api.eflow.team/v1
security: []
tags:
  - name: Reporting
    description: Conversion reporting and management endpoints.
paths:
  /networks/reporting/conversions/{conversionId}/notes:
    put:
      tags:
        - Reporting
      summary: Update Conversion Notes
      parameters:
        - in: path
          name: conversionId
          required: true
          schema:
            type: string
          description: The conversion ID to update.
      requestBody:
        required: true
        content:
          application/json:
            example:
              notes: Verified with advertiser — approved manually
            schema:
              type: object
              required:
                - notes
              properties:
                notes:
                  type: string
                  description: >
                    Free-form notes attached to the conversion. Visible to
                    network users in the Everflow UI and returned on subsequent
                    reads of the conversion record. Pass an empty string to
                    clear existing notes.
      responses:
        '200':
          description: The updated conversion record.
          content:
            application/json:
              schema:
                type: object
                description: >
                  The full conversion record after the update — same shape as
                  the [Get Conversion By
                  ID](/api-reference/get-networksreportingconversionsbyid)
                  response. The `notes` field reflects the value that was just
                  set.
                properties:
                  conversion_id:
                    type: string
                    description: Unique conversion identifier.
                  notes:
                    type: string
                    description: The updated notes value.
                  conversion_unix_timestamp:
                    type: integer
                    description: Unix timestamp of the conversion (UTC seconds).
                  status:
                    type: string
                    description: >-
                      Conversion status (e.g. `approved`, `pending`,
                      `rejected`).
                  is_event:
                    type: boolean
                    description: Whether this record is a post-conversion event.
                  payout:
                    type: number
                    description: Partner payout amount.
                  revenue:
                    type: number
                    description: Revenue amount.
                  sale_amount:
                    type: number
                    description: Sale amount (if applicable).
                  transaction_id:
                    type: string
                    description: Associated click transaction ID.
                  relationship:
                    type: object
                    description: >-
                      Related objects (offer, advertiser, affiliate,
                      account_manager, campaign, etc.).
      security:
        - API Key: []
components:
  securitySchemes:
    API Key:
      description: The Everflow API key generated from the Control Center > Security.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````