Adobe Suite Base connections API

openapi: 3.2.0
info:
  description: "Use the Adobe Experience Platform Flow Service API to connect and activate data to various destinations within and outside of Adobe Experience Platform. This API reference is centered on exporting data to batch destinations like Amazon S3, SFTP, Azure Blob.\n>**NOTE**: Refer to [Flow Service API - Sources](https://developer.adobe.com/experience-platform-apis/references/flow-service/) if you are looking for API documentation to perform operations on *sources* in Experience Platform.\n- **Related documentation**:\n    - [Destinations overview](http://www.adobe.com/go/destinations-overview-en)\n    - [Activate data to file-based destinations - API tutorial](https://experienceleague.adobe.com/docs/experience-platform/destinations/api/activate-segments-file-based-destinations.html)\n    - [Activate data to streaming destinations - API tutorial](https://experienceleague.adobe.com/docs/experience-platform/destinations/api/streaming-destinations.html)\n    - [Update destination dataflows - API tutorial](https://experienceleague.adobe.com/docs/experience-platform/destinations/api/update-destination-dataflows.html)\n    - [Export datasets - API tutorial](https://experienceleague.adobe.com/docs/experience-platform/destinations/api/export-datasets.html)\n\n- **API paths**:\n  - PLATFORM Gateway URL: https://<span>platform.adobe.io/\n  - Base path for this API: /data/foundation/flowservice\n  - Example of a complete path: https://<span>platform.adobe.io/data/foundation/flowservice/flows\n\n- **Required headers**:\n    - All service calls require the headers `Authorization`, `x-gw-ims-org-id`, and `x-api-key`. For more information on how to obtain these values, see the [authentication tutorial](http://www.adobe.com/go/platform-api-authentication-en).\n    - All resources in Experience Platform are isolated to specific virtual sandboxes. All requests to Platform APIs require the header `x-sandbox-name` whose value is the all-lowercase name of the sandbox the operation will take place in (for example, \"prod\"). See the [sandboxes overview](https://adobe.com/go/sandbox-overview-en) for more information.\n    - All requests with a payload in the request body (such as POST, PUT, and PATCH calls) must include the header `Content-Type` with a value of `application/json`.\n\n- **API error handling**:\n    - Refer to the Experience Platform API troubleshooting guide for [FAQs](https://experienceleague.adobe.com/docs/experience-platform/landing/troubleshooting.html#faq), [API status codes](https://experienceleague.adobe.com/docs/experience-platform/landing/troubleshooting.html#api-status-codes), and [request header errors](https://experienceleague.adobe.com/docs/experience-platform/landing/troubleshooting.html#request-header-errors). You can also view a list of [common Flow Service error messages](https://experienceleague.adobe.com/docs/experience-platform/sources/errors/flow-service-errors.html) and resolution suggestions.\n\n\n- **Sorting and filtering responses**:\n    - When performing listing (GET) requests in the Flow Service API, you can use query parameters to [sort and filter responses](https://experienceleague.adobe.com/docs/experience-platform/dataflows/api/sort-and-filter.html)."
  title: Flow Service API - Destinations Base connections API
  version: 1.0.0
servers:
- url: https://{environment}.adobe.io/data/foundation/flowservice
  description: Adobe IO gateway endpoint
  variables:
    environment:
      default: platform
      enum:
      - platform
      - platform-stage
tags:
- name: Base connections
  description: 'Base connections retain information regarding how to connect to a source or target.  For destinations, the source that you are connecting to is Experience Platform data and the target is the desired destination.  The base connection configuration always includes a unique `connectionSpec ID`, which is necessary in order to successfully access Experience Platform data and authorize a connection to the target destination.

    '
paths:
  /connections:
    get:
      tags:
      - Base connections
      summary: Retrieve a list of destination base connections
      description: "You can retrieve a list of all destination base connections for your organization by making a GET request to the `/connections` endpoint.\n\nYou can use query parameters to return only the base connections for a specific destination type. To do this, pass in the `connectionSpec.id` of the desired destination by using the `property` query parameter, as shown further below.\n        \n>**NOTE**: This operation allows you to retrieve a maximum of 100 entities. The most recently created or updated entities are returned first. Use filters to return the base connections that are most relevant to you.\n"
      operationId: getConnections
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XApiKey'
      - $ref: '#/components/parameters/XImsOrgId'
      - $ref: '#/components/parameters/XSandboxId'
      - $ref: '#/components/parameters/Accept'
      - in: query
        name: property
        description: 'A comma-separated list of top-level object properties to be returned in the response. Used to cut down the amount of data returned in the response body. For example, `property=id==f2d1a98b-6b8c-420b-80a1-696c3f192eb2,b6730e09-7da6-40e2-b5cf-289545056dc3,49d17eff-9fa7-4e92-b84e-ab65fcb4730a`.

          '
        required: false
        schema:
          type: string
        examples:
          filterS3Connection:
            summary: Filter to return connections for Amazon S3 destinations only.
            value: connectionSpec.id==4fce964d-3f37-408f-9778-e597338a21ee
          filterSftpConnection:
            summary: Filter to return connections for SFTP destinations only.
            value: connectionSpec.id==36965a81-b1c6-401b-99f8-22508f1e6a26
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/orderby'
      - $ref: '#/components/parameters/count'
      - $ref: '#/components/parameters/continuationToken'
      responses:
        '200':
          description: Successful operation. A successful response returns a list of base connections that match the request parameters.
          x-summary: List of Base Connections Retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectionItem'
              examples:
                Connections:
                  $ref: '#/components/examples/ConnectionsResponse'
        '401':
          description: The token provided in the Authorization header is invalid.
          x-summary: Invalid Authorization Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error_code: 401013
                message: Oauth token is not valid
        '403':
          description: You are not authorized to perform this operation
          x-summary: Authorization Error - Access Denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: An Internal error occurred.
          x-summary: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    post:
      tags:
      - Base connections
      summary: Create a target base connection
      description: 'A target base connection authorizes the connection to your desired destination type. The required authorization parameters vary based on the destination that you are looking to connect to.

        '
      operationId: postTargetBaseConnection
      parameters:
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/Content-type'
      - $ref: '#/components/parameters/XApiKey'
      - $ref: '#/components/parameters/XImsOrgId'
      - $ref: '#/components/parameters/XSandboxId'
      - $ref: '#/components/parameters/Accept'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/Create_S3_Base_Connection_Request'
              - $ref: '#/components/schemas/Create_SFTP_Base_Connection_Request'
              - $ref: '#/components/schemas/Create_S3_Base_Connection_Request_V2'
              - $ref: '#/components/schemas/Create_SFTP_Base_Connection_Request_V2'
            examples:
              Create_S3_Base_Connection:
                $ref: '#/components/examples/Create_S3_Base_Connection'
              Create_SFTP_With_Password_Connection:
                $ref: '#/components/examples/Create_SFTP_With_Password_Base_Connection'
              Create_SFTP_With_SSH_Key_Connection:
                $ref: '#/components/examples/Create_SFTP_With_SSH_Key_Base_Connection'
      responses:
        '201':
          description: A new base connection was successfully created. The response contains the unique identifier (ID) and the etag value of the base connection.
          x-summary: Base Connection Created Successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Create_Base_Connection_Response'
              examples:
                Create_Base_Connection_Response:
                  $ref: '#/components/examples/Create_Base_Connection_Response'
        '400':
          description: Bad request. A valid connection spec ID is required.
          x-summary: Bad Request - Invalid Connection Spec ID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Please provide a valid spec id
        '401':
          description: The token provided in the Authorization header is invalid.
          x-summary: Invalid Authorization Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error_code: 401013
                message: Oauth token is not valid
        '403':
          description: You are not authorized to perform this operation
          x-summary: Authorization Error - Access Denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: connectionSpec.version 'version' is required for spec info. Make sure to include the version parameter alongside the connectionSpec. version is usually "1.0".
          x-summary: Unprocessable Entity - Missing Required Version Parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: An Internal error occurred.
          x-summary: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /connections/{id}:
    get:
      tags:
      - Base connections
      summary: Retrieve the details of a base connection
      description: 'You can retrieve detailed information about a specific base connection by making a GET request to the `/connections` endpoint and providing the ID of the connection you want to inspect.

        '
      operationId: getConnectionById
      parameters:
      - name: id
        in: path
        description: The ID of the connection you are looking to retrieve.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XApiKey'
      - $ref: '#/components/parameters/XImsOrgId'
      - $ref: '#/components/parameters/XSandboxId'
      - $ref: '#/components/parameters/Accept'
      responses:
        '200':
          description: The specified base connection was successfully retrieved.
          x-summary: Base Connection Details Retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectionItem'
              examples:
                Amazon_S3_Connection:
                  $ref: '#/components/examples/Amazon_S3_Connection'
                SFTP_Connection:
                  $ref: '#/components/examples/SFTP_Connection'
                Amazon_S3_Connection_V2:
                  $ref: '#/components/examples/Amazon_S3_Connection_V2'
                SFTP_Connection_V2:
                  $ref: '#/components/examples/SFTP_Connection_V2'
        '401':
          description: The token provided in the Authorization header is invalid.
          x-summary: Invalid Authorization Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error_code: 401013
                message: Oauth token is not valid
        '403':
          description: You are not authorized to perform this operation
          x-summary: Authorization Error - Access Denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: The specified base connection ID was not found. The resource may have been deleted, or the requested path was entered incorrectly.
          x-summary: Not Found - Base Connection ID Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errorMessage: connections not found with id = [4890fc95-5a1f-4983-94bb-e060c08e3f]
                errorDetails: connections not found with id = [4890fc95-5a1f-4983-94bb-e060c08e3f]
        '500':
          description: An Internal error occurred.
          x-summary: Internal Server Error
          content:
            application/json:
              schema: null
          $ref: '#/components/schemas/ErrorResponse'
    patch:
      tags:
      - Base connections
      summary: Update a base connection
      description: 'You can update a base connection by making a PATCH request to the `/connections` endpoint and providing the ID of the base connection you want to update. In the body of the request, provide the updated configuration of the connection.

        '
      operationId: patchConnectionById
      parameters:
      - name: id
        in: path
        description: The ID of the connection you are looking to update.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XApiKey'
      - $ref: '#/components/parameters/XImsOrgId'
      - $ref: '#/components/parameters/XSandboxId'
      - $ref: '#/components/parameters/Accept'
      - $ref: '#/components/parameters/Content-type'
      - $ref: '#/components/parameters/if-match'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchConnectionItem'
            examples:
              Patch_Connection_Remove_Auth_Params:
                $ref: '#/components/examples/Patch_Connection_Remove_Auth_Params'
              Patch_Connection_Add_S3_Auth_Params:
                $ref: '#/components/examples/Patch_Connection_Add_S3_Auth_Params'
              Patch_Connection_Replace_Auth_Params:
                $ref: '#/components/examples/Patch_Connection_Replace_Auth_Params'
      responses:
        '200':
          description: Details of your newly updated base connection are returned.
          x-summary: Base Connection Updated Successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Patch_Connection_Response'
              examples:
                Patch_Connection_Response:
                  $ref: '#/components/examples/Patch_Connection_Response'
        '401':
          description: The token provided in the Authorization header is invalid.
          x-summary: Invalid Authorization Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error_code: 401013
                message: Oauth token is not valid
        '403':
          description: You are not authorized to perform this operation
          x-summary: Authorization Error - Access Denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: The specified base connection ID was not found. The resource may have been deleted, or the requested path was entered incorrectly.
          x-summary: Not Found - Base Connection ID Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errorMessage: connections not found with id = [ca5c6e9a-8559-4a08-97a5-f15b756da600-]
                errorDetails: connections not found with id = [ca5c6e9a-8559-4a08-97a5-f15b756da600-]
        '412':
          description: 'Pre-condition failed error. This can occur if the supplied eTag does not match the latest eTag for the resource or if the supplied eTag is not correctly wrapped in double quotes. To resolve this, you need to fetch the entity again, make sure that your changes are compatible with new version of the entity, then place the new eTag in the If-Match header, and finally make the API call, while ensuring the eTag is wrapped in double quotes "".

            '
          x-summary: Precondition Failed - ETag Mismatch
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errorMessage: Supplied version=["04001277-0000-0200-0000-62d9b13e00001"] does not match the current version on entity=["0400117f-0000-0200-0000-62d9bca50000"]
                errorDetails: Supplied version=["04001277-0000-0200-0000-62d9b13e00001"] does not match the current version on entity=["0400117f-0000-0200-0000-62d9bca50000"]
        '500':
          description: An Internal error occurred.
          x-summary: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    delete:
      tags:
      - Base connections
      summary: Delete a base connection
      description: 'You can delete the specified base connection by making a DELETE request to the `/connections` endpoint and providing the ID of the connection that you wish to delete in the request path.

        '
      operationId: deleteConnectionById
      parameters:
      - name: id
        in: path
        description: The ID of the connection you are looking to delete.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/Authorization'
      - $ref: '#/components/parameters/XApiKey'
      - $ref: '#/components/parameters/XImsOrgId'
      - $ref: '#/components/parameters/XSandboxId'
      - $ref: '#/components/parameters/Accept'
      responses:
        '202':
          description: A successful response returns HTTP status 202 (No Content) and a blank body. You can confirm the deletion by attempting a lookup (GET) request to the connection. The API will return an HTTP 404 (Not Found) error, indicating that the connection has been deleted.
          x-summary: Deletion Request Accepted
        '401':
          description: The token provided in the Authorization header is invalid.
          x-summary: Invalid Authorization Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error_code: 401013
                message: Oauth token is not valid
        '403':
          description: You are not authorized to perform this operation
          x-summary: Authorization Error - Access Denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: The specified base connection ID was not found. The resource may have been deleted, or the requested path was entered incorrectly.
          x-summary: Not Found - Base Connection ID Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errorMessage: connections not found with id = [ca5c6e9a-8559-4a08-97a5-f15b756da600-]
                errorDetails: connections not found with id = [ca5c6e9a-8559-4a08-97a5-f15b756da600-]
        '500':
          description: An Internal error occurred.
          x-summary: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  examples:
    SFTP_Connection_V2:
      summary: (Beta) SFTP connection Example.
      value:
        items:
        - id: 63e0b47b-94bd-4b20-a395-81ff6b496335
          createdAt: 1654785125699
          updatedAt: 1654791389756
          createdBy: example@AdobeID
          updatedBy: example@AdobeID
          createdClient: example_client
          updatedClient: example_updated client
          sandboxId: '{SANDBOX_ID}'
          sandboxName: '{SANDBOX_NAME}'
          imsOrgId: destinationapi@AdobeOrg
          name: (Beta) SFTP Connection
          connectionSpec:
            id: 36965a81-b1c6-401b-99f8-22508f1e6a26
            version: '1.0'
          state: enabled
          auth:
            specName: SFTP with Password
            params:
              authorizedDate: '2022-08-03'
              username: testUser
              password: testPassword
              domain: ftp.test.com
          version: '"56fda0d4-3858-4657-b679-adf65b9ddf9b"'
          etag: '"56fda0d4-3858-4657-b679-adf65b9ddf9b"'
    Create_Base_Connection_Response:
      summary: Base Connection Response
      value:
        id: 77eeb629-f08a-48e2-8c7b-e345e246ff45
        etag: '"ac00c7db-0000-0200-0000-62eabd5c0000"'
    Amazon_S3_Connection:
      summary: Amazon S3 connection Example.
      value:
        items:
        - id: 9d8159c6-9da6-4205-8507-d818d7ad7103
          createdAt: 1654785125699
          updatedAt: 1654791389756
          createdBy: example@AdobeID
          updatedBy: example@AdobeID
          createdClient: example_client
          updatedClient: example_updated client
          sandboxId: '{SANDBOX_ID}'
          sandboxName: '{SANDBOX_NAME}'
          imsOrgId: destinationapi@AdobeOrg
          name: amazon-s3
          connectionSpec:
            id: 4890fc95-5a1f-4983-94bb-e060c08e3f81
            version: '1.0'
          auth:
            specName: Access Key
            params:
              authorizedDate: '2022-08-03'
              s3SecretKey: '{SECRET_KEY}'
              s3AccessKey: '{ACCESS_KEY}'
          state: enabled
          version: '"0e0d95ae-0000-0200-0000-62a21cdd0000"'
          etag: '"0e0d95ae-0000-0200-0000-62a21cdd0000"'
    SFTP_Connection:
      summary: SFTP connection Example.
      value:
        items:
        - id: e6f3a300-0bf7-4755-b7f8-308dc2a99133
          createdAt: 1654785125699
          updatedAt: 1654791389756
          createdBy: example@AdobeID
          updatedBy: example@AdobeID
          createdClient: example_client
          updatedClient: example_updated client
          sandboxId: '{SANDBOX_ID}'
          sandboxName: '{SANDBOX_NAME}'
          imsOrgId: destinationapi@AdobeOrg
          name: amazon-s3
          connectionSpec:
            id: 64ef4b8b-a6e0-41b5-9677-3805d1ee5dd0
            version: '1.0'
          state: enabled
          auth:
            specName: Basic Authentication for sftp
            params:
              authorizedDate: '2022-08-03'
              password: testPassword
              userName: testUser
              host: ftp.test.com
          version: '"0e0d95ae-0000-0200-0000-62a21cdd0000"'
          etag: '"0e0d95ae-0000-0200-0000-62a21cdd0000"'
    Amazon_S3_Connection_V2:
      summary: (Beta) Amazon S3 connection Example.
      value:
        items:
        - id: 340d288f-c020-435d-a41f-094520fa83eb
          createdAt: 1654785125699
          updatedAt: 1654791389756
          createdBy: example@AdobeID
          updatedBy: example@AdobeID
          createdClient: example_client
          updatedClient: example_updated client
          sandboxId: '{SANDBOX_ID}'
          sandboxName: '{SANDBOX_NAME}'
          imsOrgId: destinationapi@AdobeOrg
          name: (Beta) Amazon S3
          connectionSpec:
            id: 4fce964d-3f37-408f-9778-e597338a21ee
            version: '1.0'
          auth:
            specName: Access Key
            params:
              authorizedDate: '2022-11-03'
              s3SecretKey: '{SECRET_KEY}'
              s3AccessKey: '{ACCESS_KEY}'
          state: enabled
          version: '"26013a41-0000-0200-0000-6361687a0000"'
          etag: '"26013a41-0000-0200-0000-6361687a0000"'
    Patch_Connection_Replace_Auth_Params:
      summary: Add authentication parameters to your Amazon S3 connection. Once you add new params, this will override all prior auth params.
      value:
      - op: replace
        path: /auth/params
        value:
          accessId: replaceAccessId
          secretKey: replaceSecretKey
    Patch_Connection_Remove_Auth_Params:
      summary: Remove Auth params to your connection
      value:
      - op: remove
        path: /auth/params
        value:
          accessId: exampleAccessId
          secretKey: exampleSecretKey
    ConnectionsResponse:
      summary: Connections response example.
      value:
        items:
        - id: 9d8159c6-9da6-4205-8507-d818d7ad7103
          createdAt: 1654785125699
          updatedAt: 1654791389756
          createdBy: example@AdobeID
          updatedBy: example@AdobeID
          createdClient: example_client
          updatedClient: example_updated client
          sandboxId: '{SANDBOX_ID}'
          sandboxName: '{SANDBOX_NAME}'
          imsOrgId: destinationapi@AdobeOrg
          name: amazon-s3
          connectionSpec:
            id: 4890fc95-5a1f-4983-94bb-e060c08e3f81
            version: '1.0'
          auth:
            specName: Access Key
            params:
              authorizedDate: '2022-08-03'
              s3SecretKey: '{SECRET_KEY}'
              s3AccessKey: '{ACCESS_KEY}'
          state: enabled
          version: '"0e0d95ae-0000-0200-0000-62a21cdd0000"'
          etag: '"0e0d95ae-0000-0200-0000-62a21cdd0000"'
        - id: e6f3a300-0bf7-4755-b7f8-308dc2a99133
          createdAt: 1654785125699
          updatedAt: 1654791389756
          createdBy: example@AdobeID
          updatedBy: example@AdobeID
          createdClient: example_client
          updatedClient: example_updated client
          sandboxId: '{SANDBOX_ID}'
          sandboxName: '{SANDBOX_NAME}'
          imsOrgId: destinationapi@AdobeOrg
          name: amazon-s3
          connectionSpec:
            id: 64ef4b8b-a6e0-41b5-9677-3805d1ee5dd0
            version: '1.0'
          state: enabled
          auth:
            specName: Basic Authentication for sftp
            params:
              authorizedDate: '2022-08-03'
              password: testPassword
              userName: testUser
              host: ftp.test.com
          version: '"0e0d95ae-0000-0200-0000-62a21cdd0000"'
          etag: '"0e0d95ae-0000-0200-0000-62a21cdd0000"'
        - id: 340d288f-c020-435d-a41f-094520fa83eb
          createdAt: 1634785125699
          updatedAt: 1644791389756
          createdBy: example@AdobeID
          updatedBy: example@AdobeID
          createdClient: example_client
          updatedClient: example_updated client
          sandboxId: '{SANDBOX_ID}'
          sandboxName: '{SANDBOX_NAME}'
          imsOrgId: destinationapi@AdobeOrg
          name: (Beta) Amazon S3 Connection
          connectionSpec:
            id: 4fce964d-3f37-408f-9778-e597338a21ee
            version: '1.0'
          auth:
            specName: Access Key
            params:
              authorizedDate: '2022-11-03'
              s3SecretKey: '{SECRET_KEY}'
              s3AccessKey: '{ACCESS_KEY}'
          state: enabled
          version: '"26013a41-0000-0200-0000-6361687a0000"'
          etag: '"26013a41-0000-0200-0000-6361687a0000"'
        - id: 63e0b47b-94bd-4b20-a395-81ff6b496335
          createdAt: 1674785125699
          updatedAt: 1684791389756
          createdBy: example@AdobeID
          updatedBy: example@AdobeID
          createdClient: example_client
          updatedClient: example_updated client
          sandboxId: '{SANDBOX_ID}'
          sandboxName: '{SANDBOX_NAME}'
          imsOrgId: destinationapi@AdobeOrg
          name: (Beta) SFTP Connection
          connectionSpec:
            id: 36965a81-b1c6-401b-99f8-22508f1e6a26
            version: '1.0'
          state: enabled
          auth:
            specName: SFTP with Password
            params:
              authorizedDate: '2022-08-03'
              username: testUser
              password: testPassword
              domain: ftp.test.com
          version: '"56fda0d4-3858-4657-b679-adf65b9ddf9b"'
          etag: '"56fda0d4-3858-4657-b679-adf65b9ddf9b"'
    Create_SFTP_With_Password_Base_Connection:
      summary: Authorize the connection to an SFTP instance with password authentication
      value:
        name: SFTP with Password Base Connection
        auth:
          specName: Basic Authentication for sftp
          params:
            domain: '{DOMAIN}'
            host: '{HOST}'
            username: '{USERNAME}'
            password: '{PASSWORD}'
        connectionSpec:
          id: 36965a81-b1c6-401b-99f8-22508f1e6a26
          version: '1.0'
    Create_S3_Base_Connection:
      summary: Authorize the connection to an Amazon S3 instance with access key authentication
      value:
        name: Amazon S3 Base Connection
        auth:
          specName: Access Key
          params:
            s3SecretKey: <Add secret key>
            s3AccessKey: <Add access key>
        connectionSpec:
          id: 4fce964d-3f37-408f-9778-e597338a21ee
          version: '1.0'
    Patch_Connection_Add_S3_Auth_Params:
      summary: Add authentication parameters to your Amazon S3 connection. Once you add new params, this will override all prior auth params.
      value:
      - op: add
        path: /auth/params
        value:
          accessId: exampleAccessId
          secretKey: exampleSecretKey
    Create_SFTP_With_SSH_Key_Base_Connection:
      summary: Authorize the connection to an SFTP instance with SSH Key authentication
      value:
        name: SFTP with SSH Key Base Connection
        auth:
          specName: SSH PublicKey Authentication for sftp
          params:
            domain: '{DOMAIN}'
            host: '{HOST}'
            username: '{USERNAME}'
            sshKey: '{SSH_KEY}'
            port: 22
        connectionSpec:
          id: 36965a81-b1c6-401b-99f8-22508f1e6a26
          version: '1.0'
  parameters:
    XApiKey:
      in: header
      name: x-api-key
      description: The API key which can be copied from your Experience Platform integration. For more information on how to obtain this value, visit the [authentication tutorial](http://www.adobe.com/go/platform-api-authentication-en).
      schema:
        type: string
      required: true
    if-match:
      in: header
      name: if-match
      description: A header containing the eTag value of the entity to be updated (destination dataflow, base or target connection, etc.). Perform a GET request to return the latest eTag version of the entity. Note that you always need to wrap this header in double quotes when using it.
      schema:
        type: string
      required: true
    orderby:
      in: query
      name: orderby
      description: Sort response by specified fields separated by `,` and/or prefix field with `-` for descending order.
      required: false
      schema:
        type: string
    Accept:
      in: header
      name: Accept
      description: An optional co

# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/adobe-suite/refs/heads/main/openapi/adobe-suite-base-connections-api-openapi.yml