Delete a permission set

DELETE

/api/v2/permission-sets/{permission_set_id}

Soft-delete a permission set and clean up its SpiceDB relationships.
System permission sets cannot be deleted.

Path Parameters:

permission_set_id (uuid): ID of the permission set to delete.

Request Headers:

X-Organization-Id (int, optional): Override the org scoping these permission sets.
Requires manage (admin) access to the specified organization.

Returns:

The deleted permission set's permission_set_id and deleted_at timestamp
under data.

X-Authorization-Consistency-Token (string): Authorization consistency token returned after a write operation. Pass this in subsequent read requests to ensure read-after-write consistency.

Current Version:

2.0.0

Request

Path Params

Header Params

Responses

🟢200

application/json

Permission set deleted successfully

Bodyapplication/json

🟠400

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request DELETE 'https:///api/v2/permission-sets/' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "permission_set_id": "5849c88b-869e-4e24-b3b2-65918c11a4a7",
        "deleted_at": "2019-08-24T14:15:22.123Z"
    }
}

Update a permission set

List permission set members