DELETE ProcessingEngines/Folder/{folder guid}/{engine guid}

Releases a Platforms engine from the ability to control certificate management on a Policy folder.

Requirements

  • Permissions: The caller must have Manage permission to the Policy folder. The caller must also have View permission on the Platforms engine.
  • 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

{engine guid}

Specify this parameter as part of the URL. A GUID that uniquely identifies a Platforms engine. To get the Engine GUID, call GET ProcessingEngines or use the UI. For example, in the Platforms tree, use the Venafi Platform value that appears on the Support tab.

Platforms Engine Guid

{folder guid}

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}/{engine Guid} returns a HTTP 200 message and an empty message body.

HTTP 401

Returns Unauthorized if the caller is missing the necessary permissions.

Example: Release all Platforms engines from controlling of a policy folder

Request

DELETE https://tpp.venafi.example/vedsdk/ProcessingEngines/Folder/{067e26e2-5536-4a6d-915b-fbf28496125c}/
{c4152110-1ec9-4f62-99fe-869d66264c34}
Authorization:Bearer 4MyGeneratedBearerTknz==

Response

HTTP/1.1 200 OK
{

}