# Add mappings for mapping algorithm

Endpoint: POST /mapping-algorithms/{algorithmName}/add-mappings
Version: 5.1.47
Security: api_key

## Path parameters:

  - `algorithmName` (string, required)
    The name of the mapping algorithm.

## Query parameters:

  - `fileReferenceId` (string, required)
    The reference URI of the uploaded file to be installed. This file should have been uploaded via the /fileUpload endpoint.

  - `passphrase` (string)
    The passphrase that an exported CSV mapping file was encrypted with. This is only needed if adding mappings that were previously exported.

  - `mappingFileType` (string)
    The type of the file provided. If PLAINTEXT is chosen, the file is expected to contain newline delimited outputs. If CSV is chosen, the file is expected to conform to RFC4180. Additionally, 2 columns are expected - input and output. The first row of the CSV must be a header.
    Enum: "PLAINTEXT", "CSV"

## Response 200 fields (application/json):

  - `asyncTaskId` (integer)
    The ID of the AsyncTask. This field will be generated by the Masking Engine.
    Example: 1

  - `operation` (string)
    The type of operation that the AsyncTask is performing.
    Enum: "ADD_MAPPINGS", "ALGORITHM_CREATE", "ALGORITHM_MIGRATE", "ALGORITHM_UPDATE", "DATAFILE_BULK_UPDATE", "ENCRYPTION_KEY_CREATE", "EXPORT", "EXPORT_CLASSIFIER_FILES", "EXPORT_MAPPINGS", "EXPORT_PROFILE_SET", "EXPORT_SL_VALUES", "GENERATE_EXECUTION_INVENTORY", "IMPORT", "RULESET_REFRESH", "TABLE_BULK_UPDATE", "MAINFRAME_DATASET_BULK_UPDATE", "SUPPORT_BUNDLE_GENERATE"

  - `reference` (string)
    The reference for the AsyncTask. An example of a reference is the ruleset ID for a RULESET_REFRESH operation.
    Example: 13

  - `status` (string)
    The status of the AsyncTask in regard to its completion.
    Enum: "CANCELLED", "FAILED", "RUNNING", "SUCCEEDED", "WAITING"

  - `startTime` (string)
    The date and time that this AsyncTask was started.

  - `endTime` (string)
    The date and time that this AsyncTask completed.

  - `cancellable` (boolean)
    True if the AsyncTask can be cancelled, false otherwise.

  - `exceptionDetail` (string)
    The details associated with the Java exception that caused this async task to fail, if applicable.


## Response 400 fields

## Response 403 fields

## Response 404 fields