Delete API version
DELETE /apim/{path_to_apiversion}
Overview
This API soft deletes the API version. It is recoverable from recycle bin as it is a soft delete.
Note: As an Org admin, you can use the Recycle Bin to recover or permanently remove deleted
endpoint accounts, files, pipelines, tasks, project spaces, and projects. Deleted items
can be recovered in 30 days unless you delete them permanently. Learn More about Recycle Bin.
Prerequisites
- Environment (Org) admin permissions
Request
DELETE https://{controlplane_path}/api/1/rest/public/apim/{path_to_apiversion}?{query_parameters}
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:
|
path_to_apiversion |
Required. The path to the SnapLogic API version.
Format: Important: The path is case sensitive
|
Query Parameters
Key | Type | Description |
---|---|---|
force |
boolean |
|
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
None.
Response
Response Body
{
"response_map": {
"success": {
"success": {
"disabled_jobs": [
{
"/Automation2/apim/api/1.0": []
},
{
"/Automation2/apim/api/1.1": []
}
],
"deleted_plexes": [plex1,plex2],
"path": "/Automation2/apim/api"
}
}
},
"http_status_code": 200
}
Key | Type | Description |
---|---|---|
disabled_jobs |
array | Paths to the disabled tasks in the API version. |
deleted_plexes |
array | Paths to the disabled plexes. |
path |
array | All the assets in the API version. |
Error Handling
HTTP Status Codes | Message | Resolution |
---|---|---|
404 |
{"message": "The requested resource at the supplied path does not
exist: /org_name/apim/api_version"} |
|
400 |
{"message":"Published/Deprecated API Versions cannot be deleted,
Unpublish/Retire the api first to remove."} |
Unpublish or deprecate the API version to delete it. |