2106: Accept permission

Accept a permission for an entity

Endpoint ID:

2106

Method:

POST

URL:

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

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

entityID

dialogportal™ master key that uniquely identifies the entity

ext-key

External key that uniquely identifies the entity

ext-type

Type of external key

permissionID

A GUID string identifier for the permission

Request body:

JSON data containing the permission acceptance

Required fields
	sourceID	The GUID string identifier of the acceptance source

{
    "sourceID": "26f2da92-c9ca-4a82-90f0-8a8a43534239"
}

Response body:

{
    "isActive": true,
    "isWithdrawn": false,
    "permissionID": "ff11961d-8ae7-4508-aed7-867220a89668",
    "acceptance": {
        "timestamp": "utc timestamp",
        "sourceID": "26f2da92-c9ca-4a82-90f0-8a8a43534239"
    }
}

Status codes:

201

The permission was accepted

303

This permission has already been accepted by this entity

400

The permission could not be accepted, because it is inactive, or due to an invalid sourceID

404

The entity or permission were not found.

The following sub codes may be returned:

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

412

The contract does not allow access to this permission, or allow this acceptance source