Checkout API version from Git

POST /apim/checkout/{path_to_apiversion}

Overview

This API checks out the specified Git branch for the specified API version. Equivalent to git checkout.

You can use Git APIs in Continuous Integration / Continuous Deployment (CI/CD) workflows to pull files from Git repositories. You can use this API to update a project to a newly tagged version or to revert to a previously stable tag.

Note:

The API version must already exist.
You can track a maximum of 1000 assets per API version. 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

Write access to the assets to be added or updated

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/checkout/{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

{
    "repo":"...",
    "ref": "...",
    "hard_reset": true,
    "discard_untracked_file": true
}


Key	Type	Description
`repo`	string	The Git repository containing the files to use with the new API version.
`ref`	string	The name of the branch containing the files to use with the new API version.
`hard_reset`	boleean	If `true`, modified assets are discarded and new assets are force-pulled from the repository. Default: False
`discard_untracked_file`	boleean	If `true`, untracked assets are discarded. Default: False

Response

Response Body

 {
  "response_map": {
    "status": "",
    "overwritten": [ ... ],
    "updated": [ ... ],
    "error_msgs": [ ... ],
    "created": [ ... ],
    "ignored": [ ... ]
  },
  "http_status_code": 200
}


Key	Type	Description
`status`	string	The status of the git checkout command performed using the Public API.
`overwritten`	array	The list of files that were overwritten in the API version in SnapLogic specified project.
`ignored`	array	Asset files that exist in the Git repository but were not copied into the project.
`updated`	array	The list of files that were updated in the API version in SnapLogic specified project.
`created`	array	Assets files that were copied from the Git respository into the API version
`error_msgs`	array/string	Any error messages that appear when the git checkout command is performed.