Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Update incorrect URLs


Excerpt

Fetch entity preference subscription details for all preferences


has not opted into any preferences
Endpoint ID:22102310
Method:

Status
colourGreen
titleGET

URL:

/preferences/entity/id/{entityID}/preference

/preferences/entity/ext-key/{ext-key}/{ext-type}/preference


entityIDRubiq master ID that uniquely identifies the entity

ext-keyRubiq master ID External key that uniquely identifies the entity

ext-typeType of external key
Request body:None


Span
stylewhite-space: nowrap
Response body:


JSON data containing an array of preferences that the entity has opted in toall preferences, with the preferenceID and a boolean optedIn property indicating the entity's preference subscription status.

title
Code Block
titleThe entity has opted in to a single preference
{
    "preferencesentityPreferences": [
        {
            "idpreferenceID": "7a6776a3-9411-4d34-9866-99aa9ac7cc27",
            "nameoptedIn": "Preference 1",false
            "description": "This explains everything",
            "isActive": true,
            "labels": [
       },
        {
                    "language"preferenceID": "dadd9eaf78-18ff-44ea-9717-25b103060643",
      
             "labeloptedIn": "Tekst",
                    "isDefault": true
                },
                {
                    "language": "en",
                    "label": "Text",
                    "isDefault": false
                }
           
]         }
    ]
}
Code Block



Status codes:200OK

404

The entity

{
    "preferences": []
}
Status codes:200OK
404Preference not found - only returned when a preferenceID parameter is included in the request

was not found

The following sub codes may be returned:

404.1 Entity not found

404.2 External entity reference not found