---
title: "Reset asset permissions to inherited"
method: PUT
path: "/api/v1/permissions/{assetId}/_reset"
tags: ["Permissions"]
---

# Reset asset permissions to inherited

`PUT /api/v1/permissions/{assetId}/_reset`

Removes all individual permissions from an asset, making it inherit permissions from its parent in the hierarchy. Only admin users can access this endpoint. Returns 409 Conflict if the asset already inherits.

## Path parameters

- `assetId` string, required

## Response `200`

Permissions reset successfully

- ResponseEntityResetPermissionsView
  - `errors` ErrorEntity[]
    - `errorCode` string
    - `message` string
    - `fieldName` string
  - `entity` ResetAssetPermissionsView
    - `message` string, required — Success message describing the operation result
    - `assetId` string, required — The identifier of the asset whose permissions were reset
    - `previousPermissionCount` integer, required — Number of individual permissions that were removed during the reset operation
  - `messages` MessageEntity[]
    - `message` string
  - `i18nMessagesMap` object
  - `permissions` string[]
  - `pagination` Pagination
    - `currentPage` integer
    - `perPage` integer
    - `totalEntries` integer

## Other responses

- `400` — Bad request - invalid asset ID
- `401` — Unauthorized - authentication required
- `403` — Forbidden - user is not admin
- `404` — Asset not found
- `409` — Conflict - asset already inherits permissions from parent

---

[API](https://skmtc.dev/jostens/apis/dotcms-rest-api.md) · [All operations](https://skmtc.dev/jostens/apis/dotcms-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jostens/dotcms-rest-api/revisions/a088fe9f515c/schema)
