Sign in

v1

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

Deletes an existing policy from the AgentCore Policy system. Once deleted, the policy can no longer be used for agent behavior control and all references to it become invalid. This is an asynchronous operation. Use the <code>GetPolicy</code> operation to poll the <code>status</code> field to track completion.

delete/policy-engines/{policyEngineId}/policies/{policyId}

Path parameters

policyEngineIdstring required

The identifier of the policy engine that manages the policy to be deleted. This ensures the policy is deleted from the correct policy engine context.

policyIdstring required

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

Response

Success

policyIdstring required

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

namestring required

The customer-assigned name of the deleted policy. This confirms which policy was successfully removed from the system and matches the name that was originally assigned during policy creation.

policyEngineIdstring required

The identifier of the policy engine from which the policy was deleted. This confirms the policy engine context for the deletion operation.

createdAtstring date-time required

The timestamp when the deleted policy was originally created.

updatedAtstring date-time required

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

policyArnstring required

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

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

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

enforcementMode'ACTIVE' | 'LOG_ONLY'

The enforcement mode of the deleted policy.

descriptionstring password

The human-readable description of the deleted policy.

statusReasonsString[] required

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