DELETE ProcessingEngines/Folder/{folder guid}

Important! This page is no longer supported or being updated. It is left here for reference purposes. We encourage you to find corresponding information in our new API Reference documentation.

Releases all Platforms engine assignments from the ability to control certificate management on Policy folders.

Requirements

  • Permissions: The caller must have Manage permission to the Policy folder.
  • Token scope:  Configuration:Delete

Headers

  • Content type: Content-Type:application/json.

  • Token: The bearer access token that you received. For example, Authorization:Bearer 4MyGeneratedBearerTknz==. For more information, see Passing a bearer token in your API calls.

Parameters

Input parameters

Name

Description

{folder guid}

(resource)

Specify this parameter as part of the URL. A GUID that uniquely identifies a Policy folder. Depending on your environment, the GUID may be expressed with or without curly braces {}. For example, {3d6b61d-1c71-4603-883f-25b8c2ceecdd}. In the Policy tree, use the Policy value that appears on the Support tab.

Processing Engine Folder Guid

Returns

Response description

Name

Description

HTTP 200

For valid requests, DELETE ProcessingEngines/Folder/{folder guid} returns an empty message body.

HTTP 400

Returns Bad Request for the following reasons:

  • Config object errors.
  • Missing resource id: [FolderGuid].
  • Session errors.

Example: Release all Platform engine controls from a Policy folder

Request

DELETE https://tpp.venafi.example/vedsdk/ProcessingEngines/Folder/{067e26e2-5536-4a6d-915b-fbf28496125c} Authorization:Bearer 4MyGeneratedBearerTknz==

Response

HTTP/1.1 200 OK { }