Revoke Permission

DELETE /permissions/{permissionId}/assignments/{assignmentId}

Revokes a permission assignment (success) or gives reason why it’s not possible (failure).

• User action signature required. See User Action Signing for more information.

• Request headers required. See Request Headers for more information.

• Authentication required. See Authentication Headers for more information.

Required Permissions

Name	Conditions
PermissionAssignments:Revoke	Always Required

Parameters

Path parameters

Path parameter	Description
permissionId	Unique identifier of the permission. Permission IDs look like this: pm-stream-pizza-08edcfff93
assignmentId	Unique identifier of the permission assignment. Permission Assignment IDs look like this: as-stream-pizza-08edcfff93

Response

Response example 204 - no approval required

If successful, the response will be a 204 status code.

Response example 202 - approval required

// permission assignment change request
{
   "id":"cr-...",
   "kind":"Assignment",
   "operationKind":"Delete",
   "status":"Pending",
   "dateCreated":"2023-12-22T20:57:55.814Z",
   "dateResolved":"2023-12-22T20:57:55.814Z",
   "entityId":"plc-...",
   "requester":{
      "appId":"ap-...",
      "userId":"us-...",
      "tokenId":"to-..."
   },
   "body":{
      "id":"as-stream-pizza-08edcfff93",
      "permissionId":"pm-orange-apple-2b17a80613",
      "identityId":"oe-louisiana-one-6cf5e80c205c",
      "isImmutable":false,
   },
}

This is a hard deletion, not an archival.