---
title: "DELETE /deletepermissionversion#permissionArn&permissionVersion"
method: DELETE
path: "/deletepermissionversion#permissionArn&permissionVersion"
---

# DELETE /deletepermissionversion#permissionArn&permissionVersion

`DELETE /deletepermissionversion#permissionArn&permissionVersion`

Deletes one version of a customer managed permission. The version you specify must not be attached to any resource share and must not be the default version for the permission.

If a customer managed permission has the maximum of 5 versions, then you must delete at least one version before you can create another.

## Query parameters

- `permissionArn` string, required
- `permissionVersion` integer, required
- `clientToken` string

## Response `200`

Success

- DeletePermissionVersionResponse
  - `returnValue` boolean — A boolean value that indicates whether the operation is successful.
  - `clientToken` string — The idempotency identifier associated with this request. If you want to repeat the same operation in an idempotent manner then you must include this value in the <code>clientToken</code> request parameter of that later call. All other parameters must also have the same values that you used in the first call.
  - `permissionStatus` 'ATTACHABLE' | 'UNATTACHABLE' | 'DELETING' | 'DELETED' — This operation is performed asynchronously, and this response parameter indicates the current status.

## Other responses

- `480` — MalformedArnException
- `481` — InvalidParameterException
- `482` — ServerInternalException
- `483` — ServiceUnavailableException
- `484` — OperationNotPermittedException
- `485` — UnknownResourceException
- `486` — InvalidClientTokenException
- `487` — IdempotentParameterMismatchException

---

[API](https://skmtc.net/aws/apis/ram.md) · [All operations](https://skmtc.net/aws/apis/ram/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/ram/revisions/61869c19b93e/schema)