v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141531,219979.8 KB

Deletes an existing policy engine from the AgentCore Policy system. The policy engine must not have any associated policies before deletion. Once deleted, the policy engine and all its configurations become unavailable for policy management and evaluation. This is an asynchronous operation. Use the <code>GetPolicyEngine</code> operation to poll the <code>status</code> field to track completion.

delete/policy-engines/{policyEngineId}

Path parameters

policyEngineIdstring required

The unique identifier of the policy engine to be deleted. This must be a valid policy engine ID that exists within the account.

Response

Success

policyEngineIdstring required

The unique identifier of the policy engine being deleted. This confirms which policy engine the deletion operation targets.

namestring required

The customer-assigned name of the deleted policy engine.

createdAtstring date-time required

The timestamp when the deleted policy engine was originally created.

updatedAtstring date-time required

The timestamp when the deleted policy engine was last modified before deletion. This tracks the final state of the policy engine before it was removed from the system.

policyEngineArnstring required

The Amazon Resource Name (ARN) of the deleted policy engine. This globally unique identifier confirms which policy engine resource was successfully removed.

status'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED' required

The status of the policy engine deletion operation. This provides status about any issues that occurred during the deletion process.

encryptionKeyArnstring

The Amazon Resource Name (ARN) of the KMS key used to encrypt the policy engine data.

descriptionstring password

The human-readable description of the deleted policy engine.

statusReasonsString[] required

Additional information about the deletion status. This provides details about the deletion process or any issues that may have occurred.