Discard local changes

POST /apim/discard_changes/{path_to_apiversion}

Overview

Discard local changes to the listed assets in the API version.
Note: You can track a maximum of 1000 assets per project. If a check-in would exceed 1000 assets in the repository or if you try to check out a project with more than 1000 assets, an error is thrown.

Prerequisites

  • Git hosting provider requirements:
    • The environment (Org) must be correctly configured to use a Git hosting provider supported by SnapLogic.
    • The user must have an authenticated account with the Git hosting provider.

    Learn more: SnapLogic - Git Integration

Limitations

  • You cannot use SnapLogic service accounts to call any of the SnapLogic API Management Git operation APIs.

Request

 POST https://{controlplane_path}/api/1/rest/public/apim/discard_changes/{path_to_apiversion}

Path Parameters

Key Description
controlplane_path Required. The path to the SnapLogic control plane.

Example: cdn.elastic.snaplogic.com

For other control planes, substitute the subdomain name for elastic. For example:
  • cdn.uat.snaplogic.com
  • cdn.emea.snaplogic.com
path_to_apiversion Required. The path to the SnapLogic API version.

Format: /org_name/apim/api/apiversion

Important: The path comparison is case-sensitive.

Query Parameters

None.

Request Header

Specify Basic for authorization and application/json for content type.


Authorization: Basic {your_encoded_security_credentials}
Content-Type: application/json
          

Request Body

A list of assets to discard.

{
    "asset_names" : ["file1.txt","file2.txt"]
}
        
Key Type Description
"asset_names" array A comma-separated list of the asset names for which to discard changes.

Response

Response Body


{
    "response_map": [
        {
            "org_name/apim/api/1.0": {
                "status": "updated",
                "overwritten": [
                    "file.txt"
                ],
                "ignored": [],
                "updated": [],
                "created": [],
                "error_msgs": []
            }
        }
    ],
    "http_status_code": 200
}
        
Key Type Description
status string The status of the process.
overwritten array The assets whose state was refreshed from the repository.
ignoredarrayAn empty list.
updated array An empty list.
createdarrayAn empty list.
error_msgs array Any error messages that were thrown during the process.