Versions Compared

Old Version 11

changes.mady.by.user Nick Jensen

Saved on

compared with

New Version 12

changes.mady.by.user Nick Jensen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add 412 response

...

Endpoint ID:2102
Method:

Status
colourGreen
titlePOST

URL:

/permissions/entity/id/{entityID}/terms/{termsID}

/permissions/entity/ext-key/{ext-key}/{ext-type}/terms/{termsID}


entityID

dialogportal™ master key that uniquely identifies the entity

ext-keyExternal key that uniquely identifies the entity

ext-typeType of external key

termsIDA GUID string identifier for the terms


Span
stylewhite-space:nowrap

Request body:


JSON data describing the terms acceptance

Required fields
 sourceIDThe ID of the acceptance source
Optional fields
 termsVersionThe version of the terms which is being accepted, in major.minor format.


Code Block
{
    "sourceID": 234,
    "termsVersion": "1.3"
}


Response body:


Code Block
{
    "isActive": true,
    "isWithdrawn": false,
    "terms": {
        "id": "1f788c79-7dde-407f-a976-6b08ffb4c75a",
        "version": "1.3",
        "isMostRecentVersion": true
    },
    "acceptance": {
        "timestamp": "utc timestamp",
        "sourceID": 123
    }
}


Status codes:201Terms were accepted

303These terms have already been accepted by this entity

400Terms could not be accepted, due to an invalid version or sourceID

404

The entity or terms were not found.

The following sub codes may be returned:

404.1Entity not found
404.2External entity reference could not be found
404.4Terms not found



412The contract does not allow access to these terms, or allow this acceptance source