System - Update web-part properties

API Url

Used for updating one or more web-part properties of a specific web-part instance, taking also into consideration the ProMark role (Employee/User).

PUT
http://localhost:16010/ProMarkREST/rest/System/webparts/{id}/properties

Permissions: user

Path parameters

FieldTypeDescription
idNumber

Unique identifier of the web-part instance.

Query parameters

FieldTypeDescription
leveloptionalNumber

The level at which the properties are saved.(5 = System, 10 = Employee category, 15 = User profile)

levelIdoptionalString

The category or user profile. (Only for level > 5)

Parameter

FieldTypeDescription
requestObject

Main object containing the request data.

  dataObject

Object containg data to be uploaded.

    propertiesObject[]

Collection of web-part properties.

      idString

Property unique identifier (not updatable).

      lockedBoolean

true = Web-part property is read-only (not updatable).

      nameString

Name of property (not updatable).

      typeNumber

Type of property (not updatable).

      valueString

Value of property.

      visibleBoolean

true = Web-part property is visible to the user (not updatable).

Request example:

{
"request": {
"data": {
"properties":[
{
"id": "AbsCol",
"name": "Show ProMark absence colors",
"value": "TRUE",
"type": 2,
"visible": true,
"locked": false
}
]
}
}
}

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  messageoptionalObject

Object containing response messages.

    codeNumber

Message code.

    textString

Message text.

    typeString

Type of message.

Allowed values:"warning""info"

Error 4xx

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.