Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt

Withdraw a permission for an entity


Endpoint ID:
2104
2109
Method:

Status
colourGreen
titlePUT

URL:

/permissions/entity/id/{entityID}/permission/{permissionID}/withdraw

/permissions/entity/ext-key/{ext-key}/{ext-type}/permission/{permissionID}/withdraw


entityID

dialogportal™ master key that uniquely identifies the entity

ext-keyExternal key that uniquely identifies the entity

ext-typeType of external key

permissionIDA GUID string identifier for the permission
Request body:

JSON data describing the permission withdrawal

Required fields
 sourceIDThe ID of the withdrawal source

reasonA reason for the withdrawal


Code Block
{
    "sourceID": 234,
    "reason": "Abc"
}



Span
stylewhite-space:nowrap

Response body:


None
Status codes:204The permission was withdrawn

404

The entity or permission were not found.

The following sub codes may be returned:

404.1Entity not found
404.2External entity reference could not be found
404.5Permission not found