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.elastic.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

Basic authentication

In the request header, specify Basic for authorization, add your credentials (Login and password of your SnapLogic user or service account), and specify application/json for content type. For more details on accounts refer to Manage accounts.


Authorization: Basic {base64_encoded <email>:<password>}
Content-Type: application/json

Example of Basic authenthication using Postman

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.