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

# Exchange the specified certificate with a trading partner. Only applicable for AS2 and OFTP connectors.

> Exchange the specified certificate with a trading partner. Only applicable for AS2 and OFTP connectors.



## OpenAPI

````yaml 26.3/self-hosted/en/api-reference/openapi.json POST /exchangeCert
openapi: 3.0.1
info:
  title: RSSBus OpenAPI
  version: 26.3.9712.0
servers:
  - url: '{baseUrl}'
    variables:
      baseUrl:
        default: https://arc.example.com/api.rsc
        description: >-
          Base URL of your Arc instance, including scheme and application path
          (e.g. https://arc.example.com/api.rsc).
security: []
paths:
  /exchangeCert:
    post:
      tags:
        - exchangeCert
      summary: >-
        Exchange the specified certificate with a trading partner. Only
        applicable for AS2 and OFTP connectors.
      description: >-
        Exchange the specified certificate with a trading partner. Only
        applicable for AS2 and OFTP connectors.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/exchangeCert_input'
        required: true
      responses:
        '200':
          description: The action result
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CDataError'
      security:
        - authtoken_header: []
        - basic: []
        - authtoken_query: []
components:
  schemas:
    exchangeCert_input:
      type: object
      required:
        - WorkspaceId
        - ConnectorId
        - Certificate
        - ExchangeType
      properties:
        WorkspaceId:
          type: string
          description: >-
            The Id of the workspace containing the connector participating in
            the trading partner certificate exchange.
        ConnectorId:
          type: string
          description: >-
            The Id of the AS2 or OFTP connector sending or receiving
            certificates during the exchange process.
        PortId:
          type: string
          description: >-
            The Id of the specific connector port or endpoint handling the
            certificate exchange operation with the trading partner.
        Certificate:
          type: string
          description: >-
            The full filename of the certificate (including the extension) to be
            sent to or exchanged with the remote trading partner.
        ExchangeType:
          type: string
          description: >-
            The type of certificate exchange operation: AS2 Request/Response
            (requesting or providing certificates), or OFTP
            Deliver/Request/Replace (delivering, requesting, or updating
            certificates).
        CertificatePassword:
          type: string
          description: >-
            The password protecting the private key in the certificate being
            exchanged (AS2 exchanges only).
        CertificateUsage:
          type: string
          description: >-
            The cryptographic purposes for which the certificate can be used,
            such as encryption, signature verification, or TLS connections (AS2
            exchanges only). Available values are 'Encryption, Verification,
            ServerTLS, ClientTLS'.
        ResponseURL:
          type: string
          description: >-
            The URL endpoint where the trading partner should send their
            certificate response when you initiate an AS2 certificate request.
        RequestId:
          type: string
          description: >-
            An Id for tracking a specific AS2 certificate exchange request and
            matching it with the corresponding response.
    CDataError:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/CDataInError'
    CDataInError:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    authtoken_header:
      type: apiKey
      in: header
      name: x-cdata-authtoken
    basic:
      scheme: basic
      type: http
    authtoken_query:
      type: apiKey
      in: query
      name: '@authtoken'

````