Get preferences (map)

Get all global preferences as map (PreferenceMapContainer). URL GET <application-url>/api/instancecontrol/preference/cache

Produces

application/json
application/xml

com.matterial.mtr.api.object.PreferenceMapContainer

• 200 OK

Permission systemAccountRequired

Sample GET http://localhost:8080/mtr-backend/api/instancecontrol/preference/cache

---

Get preference by key

URL GET <application-url>/api/instancecontrol/preference/cache/bypreferencekey/<preferenceKey>

Path parameter

parameter	mandatory	possible values	default	description
preferenceKey	yes	-	-	a preference key

Produces

text/plain

String - preference-value

• 200 OK

Permission systemAccountRequired

Sample GET http://localhost:8080/mtr-backend/api/instancecontrol/preference/cache/bypreferencekey/general.application.context.backend

---

Get permission free preference by key

This resource could be invoked without being logged-in for some special pref-keys. URL GET <application-url>/api/instancecontrol/preference/cache/bypermissionfreekey/<preferenceKey>

Path parameter

• preferenceKey possible values:
  • auth.oauth2.google.supported
  • auth.oauth2.microsoft.supported
  • auth.oauth2.cobot.supported

Produces

text/plain

String - preference-value

• 200 OK

Sample GET http://localhost:8080/mtr-backend/api/instancecontrol/preference/cache/bypermissionfreekey/auth.oauth2.google.supported

---

Reinit preference-cache

URL GET <application-url>/api/instancecontrol/preference/cache/reinit

• 202 ACCEPTED

Permission systemAccountRequired

Sample GET http://localhost:8080/mtr-backend/api/instancecontrol/preference/cache/reinit

---

Store preference

URL PUT <application-url>/api/instancecontrol/preference/<preferencekey>

Consumes

text/plain

String - preference-value

Produces

• 202 ACCEPTED
• 304 NOT_MODIFIED
• 500 INTERNAL_SERVER_ERROR

Permission systemAccountRequired

Sample POST http://localhost:8080/mtr-backend/api/instancecontrol/preference/auth.ntlm.supported