---
title: "PATCH /policy-engines/{policyEngineId}"
method: PATCH
path: "/policy-engines/{policyEngineId}"
---

# PATCH /policy-engines/{policyEngineId}

`PATCH /policy-engines/{policyEngineId}`

Updates an existing policy engine within the AgentCore Policy system. This operation allows modification of the policy engine description while maintaining its identity. This is an asynchronous operation. Use the <code>GetPolicyEngine</code> operation to poll the <code>status</code> field to track completion.

## Path parameters

- `policyEngineId` string, required

## Request body

- object
  - `description` object — Wrapper for updating an optional Description field with PATCH semantics. When present in an update request, the description is replaced with optionalValue. When absent, the description is left unchanged. To unset the description, include the wrapper with optionalValue not specified.
    - `optionalValue` string, password — Represents an optional value that is used to update the human-readable description of the resource. If not specified, it will clear the current description of the resource.

## Response `202`

Success

- UpdatePolicyEngineResponse
  - `policyEngineId` string, required — The unique identifier of the updated policy engine.
  - `name` string, required — The name of the updated policy engine.
  - `createdAt` string, date-time, required — The original creation timestamp of the policy engine.
  - `updatedAt` string, date-time, required — The timestamp when the policy engine was last updated.
  - `policyEngineArn` string, required — The ARN of the updated policy engine.
  - `status` 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED', required — The current status of the updated policy engine.
  - `encryptionKeyArn` string — The Amazon Resource Name (ARN) of the KMS key used to encrypt the policy engine data.
  - `description` string, password — The updated description of the policy engine.
  - `statusReasons` String[], required — Additional information about the update status.

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — ConflictException
- `483` — ThrottlingException
- `484` — ResourceNotFoundException
- `485` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore-control.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore-control/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore-control/versions/0ebde766792b/schema)