---
title: "UpdateChannelProfileRequest"
url: "https://dev.ionova.ai/apis/ars-address-resolution-service-4/versions/fdd2c316-7f84-4f04-8bb7-64e9bf97893b/schemas/UpdateChannelProfileRequest"
---

> Full API specification: https://dev.ionova.ai/apis/ars-address-resolution-service-4/versions/fdd2c316-7f84-4f04-8bb7-64e9bf97893b.md

# UpdateChannelProfileRequest

Request body for EP-26 — Update Channel Profile (PATCH semantics). Only fields provided are updated. channelName cannot be changed via PATCH.

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: ARS — Address Resolution Service
  version: 4.3.1
servers:
  - url: https://api-uat.ionova.ai/ars
    description: UAT (test data only)
components:
  schemas:
    ChannelType:
      type: string
      description: Payment delivery channel type.
      enum:
        - api
        - file
        - other
    SchemeCode:
      type: string
      description: Payment scheme identifier.
      enum:
        - SCT
        - SCT_INST
        - SDD_CORE
        - SDD_B2B
        - OCT_INST
        - CBPRPLUS
        - CHAPS
        - T2
        - EURO1
        - FEDWIRE
        - OTHER
    SchemeVersion:
      type: string
      description: ISO 20022 scheme version / SR year.
      enum:
        - SR2025
        - SR2026
    Direction:
      type: string
      description: Payment processing direction. OUTBOUND = sending; INBOUND = receiving.
      enum:
        - OUTBOUND
        - INBOUND
    MessageType:
      type: string
      description: >
        ISO 20022 message type. R-transaction types (pain.002, pain.007,
        pacs.002,

        pacs.004, camt.029, camt.052, camt.053, camt.054, camt.055, camt.056,
        camt.058, camt.110, camt.111) must be submitted to R-transaction
        endpoints only

        (EP-07, EP-15). Submitting them to Check/Convert endpoints returns HTTP
        422 (REG-06).
      enum:
        - pain.001
        - pain.002
        - pain.007
        - pain.008
        - pacs.002
        - pacs.003
        - pacs.004
        - pacs.008
        - pacs.009
        - pacs.010
        - camt.029
        - camt.052
        - camt.053
        - camt.054
        - camt.055
        - camt.056
        - camt.057
        - camt.058
        - camt.060
        - camt.105
        - camt.106
        - camt.107
        - camt.108
        - camt.109
        - camt.110
        - camt.111
    PartyRole:
      type: string
      description: >
        ISO 20022 party role. Determines the PostalAddress24 XSD variant:

        - **__2 variant** (ultimate_debtor, ultimate_creditor,
        initiating_party):
          TownName AND Country are MANDATORY. FULLY_UNSTRUCTURED is NEVER permitted (REG-05).
        - **__1 variant** (debtor, creditor):
          Max 3 AddressLines. FULLY_UNSTRUCTURED is permitted until SR2026 cutover (2026-11-22T02:30:00Z) for INBOUND;
          banned OUTBOUND post-cutover.
      enum:
        - debtor
        - creditor
        - ultimate_debtor
        - ultimate_creditor
        - initiating_party
    OutputMode:
      type: string
      description: |
        Address line rendering constraints applied during output formatting.
        - EPC: 2 lines × 70 chars
        - CBPR_PLUS: 3 lines × 35 chars
        - MT_LEGACY: 2 lines × 35 chars
        - COMPLIANCE: 7 lines × 70 chars
      enum:
        - EPC
        - CBPR_PLUS
        - MT_LEGACY
        - COMPLIANCE
    AutoRepairMode:
      type: string
      description: ARS AutoCorrect repair aggressiveness level.
      enum:
        - CONSERVATIVE
        - STANDARD
        - AGGRESSIVE
    TargetFormat:
      type: string
      description: >
        Target conversion format. `auto` lets ARS select the best achievable
        format.
      enum:
        - auto
        - FULLY_STRUCTURED
        - HYBRID
        - FULLY_UNSTRUCTURED
    Quality:
      type: string
      description: Postal database verification depth.
      enum:
        - premium
        - standard
        - basic
    UpdateChannelProfileRequest:
      type: object
      xml:
        name: UpdateChannelProfileRequest
      description: >
        Request body for EP-26 — Update Channel Profile (PATCH semantics).

        Only fields provided are updated. channelName cannot be changed via
        PATCH.
      properties:
        channelSelection:
          type: object
          description: PATCH of channelSelection block. Only provided sub-fields are
            updated.
          properties:
            channel:
              $ref: "#/components/schemas/ChannelType"
            scheme:
              $ref: "#/components/schemas/SchemeCode"
            schemeVersion:
              $ref: "#/components/schemas/SchemeVersion"
            direction:
              $ref: "#/components/schemas/Direction"
            messageType:
              $ref: "#/components/schemas/MessageType"
            partyRole:
              $ref: "#/components/schemas/PartyRole"
            pspCountry:
              type: string
              pattern: ^[A-Z]{2}$
            payerPspCountry:
              type: string
              pattern: ^[A-Z]{2}$
            payeePspCountry:
              type: string
              pattern: ^[A-Z]{2}$
            timezone:
              type: string
        corridor:
          type: object
          properties:
            sendingCountry:
              type: string
              pattern: ^[A-Z]{2}$
            receivingCountry:
              type: string
              pattern: ^[A-Z]{2}$
            currency:
              type: string
              pattern: ^[A-Z]{3}$
        preferences:
          type: object
          properties:
            outputMode:
              $ref: "#/components/schemas/OutputMode"
            autoRepairMode:
              $ref: "#/components/schemas/AutoRepairMode"
            enforcePostNovember2026:
              type: boolean
            targetFormat:
              $ref: "#/components/schemas/TargetFormat"
            quality:
              $ref: "#/components/schemas/Quality"
            repairConfidenceThreshold:
              type: number
              minimum: 0
              maximum: 1
```