Skip to main content
DELETE
/
permissions
/
{permissionId}
/
assignments
/
{assignmentId}
Revoke Permission
curl --request DELETE \
  --url https://api.dfns.io/permissions/{permissionId}/assignments/{assignmentId} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-DFNS-USERACTION: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.dfns.co/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

✅ Organization User (CustomerEmployee)
✅ Delegated User (EndUser)
✅ Service Account

​
Required Permissions

Permissions:Revoke: Always required.

Authorizations

​
Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

​
X-DFNS-USERACTION
string
header
required

User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows

Path Parameters

​
permissionId
string
required

ID of the permission (also referred to as "role" in the dashboard).

Required string length: 1 - 64
​
assignmentId
string
required

ID of the permission assignment.

Required string length: 1 - 64
Pattern: ^as-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Query Parameters

​
force
boolean
default:false

If true, bypasses the approval process and revokes immediately.

Response

200

Success

Last modified on May 29, 2026