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: `elastic.snaplogic.com` For the UAT or EMEA control plane, substitute the name for `elastic`. For example: `uat.snaplogic.com` `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

In the request header, specify Basic for authorization, add your credentials, and specify 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.
`ignored`	array	An empty list.
`updated`	array	An empty list.
`created`	array	An empty list.
`error_msgs`	array	Any error messages that were thrown during the process.