Jump to

• Request
• Response

Batch Update User Preferences (Deprecated since 25.5)

put

/api/restapi/userPreferences/batch

Send a request to this endpoint to update one or more user preferences.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : List<ApiEntityApplicationUserSettingInput>

Type: array

Title: List<ApiEntityApplicationUserSettingInput>

Show Source

• Array of: object ApiEntityApplicationUserSettingInput
  Title: ApiEntityApplicationUserSettingInput

  This entity represents a ApplicationUserSetting object, a unique ApplicationUserSetting object can be identified by the following combinations of the fields.

  • applicationUserSettingId
  • applicationUserId,settingName

{
    "title":"List<ApiEntityApplicationUserSettingInput>",
    "type":"array",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/ApiEntityApplicationUserSettingInput",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

Nested Schema : ApiEntityApplicationUserSettingInput

Type: object

Title: ApiEntityApplicationUserSettingInput

This entity represents a ApplicationUserSetting object, a unique ApplicationUserSetting object can be identified by the following combinations of the fields.

• applicationUserSettingId
• applicationUserId,settingName

Show Source

• applicationUserId: integer (int64)
  The system-generated identifier of a user.
• applicationUserSettingId: integer (int64)
  The unique identifier of a user's settings.
• namespace: string
  Minimum Length: 1

  Maximum Length: 255

  Deprecated. As of 24.12.
  The namespace to which a user is assigned.
• settingName: string
  Allowed Values: [ "ActivitiesViewSettings", "ActivityNetworkSettings", "ReportsSummaryGridViewConfig", "DecimalPlaces", "NumberDecimalPlaces", "CurrencySymbol", "FourDigitYear", "LeadingZeros", "MonthName", "Separator", "DateFormat", "DigitGroupingSeparator", "DecimalSeparator", "DigitGroupingAndDecimalSymbols", "DigitGroupingStyle", "CurrencyNegativeFormat", "CurrencyPositiveFormat", "TabOrder", "AppVisibilityAndOrder", "ProjectCodesViewConfig", "ProfileImage", "ReportColWidth", "ReportScheduleColWidth", "ScheduleColWidth", "WorkspaceAndProjectDisplayFormat", "AnnouncementsLastReadTime", "LocationsViewConfig", "workflowTasksPrefs", "WorkflowViewLogViewConfig", "monitorWorkflowsPrefs", "startWorkflowsPrefs", "workflowDesignsPrefs", "workflowConfigsPrefs", "monitorWorkflowTasksPrefs", "formTemplatesPrefs", "formPreviewPrefs", "userDashboardPref", "SearchAll", "SearchWorkspaces", "SearchProjects", "SearchScopeItems", "SearchProjectCodes", "SearchGenericPortfolios", "SearchActivities", "SearchDocuments", "SearchUsers", "SearchRisks", "SearchIdeas", "SearchPrograms", "NumberResultsPerSearchResultsPage", "SpatialSearchDefaultUnits", "SpatialSearchDefaultDistance", "SpatialSearchAllProjectsKeywords", "TimeFormat", "DisplayTime", "StatusUpdateActivitySortOrder", "StatusUpdateActivitySortField", "StatusUpdateProjectFilter", "StatusUpdateProjectFilterArray", "StatusUpdateTaskStatusFilter", "StatusUpdateTimeframeFilter", "StatusUpdateWBSFilter", "StatusUpdateFromDateFilter", "StatusUpdateToDateFilter", "ScheduleCheckBeiTarget", "SmLayoutLatestView", "UserAppliedFilterIdList", "ShowMinutes", "DataDateInPageBanners", "ActualDateIndicator", "ConstraintDateIndicator", "ResourceAnalysisDataView", "ResourceAssignmentDataView", "DisplayUnits", "UnitsSubUnits", "UnitsLabel", "UnitsPerTimeFormat", "DisplayDuration", "DurationSubUnits", "DurationLabel", "WhenAssigningResourceToExistingActivity", "WhenResourceAndRoleShareActivityAssignment", "UnitsDecimalPlaces", "UnitsNumberDecimalPlaces", "DurationDecimalPlaces", "DurationNumberDecimalPlaces", "ImportClobberOptions", "HomeRecentsVisible", "UserFirstName", "UserLastName", "UserTitle", "UserLocale", "UserAlternateEmail", "UserPhoneNumber", "UserMobileNumber", "UserFaxNumber", "UserDisplayDensity", "UserTimeZone", "OnboardedForVersion", "WorkPlanGettingStartedShown", "CookiesAcknowledged", "PlaAccepted", "LastSearchIndexRequest", "displayScheduleLog", "LastAccessedWorkPackageId", "LastSearchIndexCompleted", "ExperimentalEnhancedPrint", "ExperimentalColumnMenu", "AutoSaveNamedViews" ]

  The name of a user setting.
• settingValue: string
  Minimum Length: 1

  Maximum Length: 4000

  The value of a user setting.

{
    "title":"ApiEntityApplicationUserSettingInput",
    "type":"object",
    "properties":{
        "namespace":{
            "maxLength":255,
            "minLength":1,
            "type":"string",
            "description":"<b>Deprecated.</b> As of <i>24.12</i>.</br>The namespace to which a user is assigned.",
            "deprecated":true,
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "applicationUserSettingId":{
            "type":"integer",
            "description":"The unique identifier of a user's settings.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "applicationUserId":{
            "type":"integer",
            "description":"The system-generated identifier of a user.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "settingName":{
            "type":"string",
            "description":"The name of a user setting.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ],
            "enum":[
                "ActivitiesViewSettings",
                "ActivityNetworkSettings",
                "ReportsSummaryGridViewConfig",
                "DecimalPlaces",
                "NumberDecimalPlaces",
                "CurrencySymbol",
                "FourDigitYear",
                "LeadingZeros",
                "MonthName",
                "Separator",
                "DateFormat",
                "DigitGroupingSeparator",
                "DecimalSeparator",
                "DigitGroupingAndDecimalSymbols",
                "DigitGroupingStyle",
                "CurrencyNegativeFormat",
                "CurrencyPositiveFormat",
                "TabOrder",
                "AppVisibilityAndOrder",
                "ProjectCodesViewConfig",
                "ProfileImage",
                "ReportColWidth",
                "ReportScheduleColWidth",
                "ScheduleColWidth",
                "WorkspaceAndProjectDisplayFormat",
                "AnnouncementsLastReadTime",
                "LocationsViewConfig",
                "workflowTasksPrefs",
                "WorkflowViewLogViewConfig",
                "monitorWorkflowsPrefs",
                "startWorkflowsPrefs",
                "workflowDesignsPrefs",
                "workflowConfigsPrefs",
                "monitorWorkflowTasksPrefs",
                "formTemplatesPrefs",
                "formPreviewPrefs",
                "userDashboardPref",
                "SearchAll",
                "SearchWorkspaces",
                "SearchProjects",
                "SearchScopeItems",
                "SearchProjectCodes",
                "SearchGenericPortfolios",
                "SearchActivities",
                "SearchDocuments",
                "SearchUsers",
                "SearchRisks",
                "SearchIdeas",
                "SearchPrograms",
                "NumberResultsPerSearchResultsPage",
                "SpatialSearchDefaultUnits",
                "SpatialSearchDefaultDistance",
                "SpatialSearchAllProjectsKeywords",
                "TimeFormat",
                "DisplayTime",
                "StatusUpdateActivitySortOrder",
                "StatusUpdateActivitySortField",
                "StatusUpdateProjectFilter",
                "StatusUpdateProjectFilterArray",
                "StatusUpdateTaskStatusFilter",
                "StatusUpdateTimeframeFilter",
                "StatusUpdateWBSFilter",
                "StatusUpdateFromDateFilter",
                "StatusUpdateToDateFilter",
                "ScheduleCheckBeiTarget",
                "SmLayoutLatestView",
                "UserAppliedFilterIdList",
                "ShowMinutes",
                "DataDateInPageBanners",
                "ActualDateIndicator",
                "ConstraintDateIndicator",
                "ResourceAnalysisDataView",
                "ResourceAssignmentDataView",
                "DisplayUnits",
                "UnitsSubUnits",
                "UnitsLabel",
                "UnitsPerTimeFormat",
                "DisplayDuration",
                "DurationSubUnits",
                "DurationLabel",
                "WhenAssigningResourceToExistingActivity",
                "WhenResourceAndRoleShareActivityAssignment",
                "UnitsDecimalPlaces",
                "UnitsNumberDecimalPlaces",
                "DurationDecimalPlaces",
                "DurationNumberDecimalPlaces",
                "ImportClobberOptions",
                "HomeRecentsVisible",
                "UserFirstName",
                "UserLastName",
                "UserTitle",
                "UserLocale",
                "UserAlternateEmail",
                "UserPhoneNumber",
                "UserMobileNumber",
                "UserFaxNumber",
                "UserDisplayDensity",
                "UserTimeZone",
                "OnboardedForVersion",
                "WorkPlanGettingStartedShown",
                "CookiesAcknowledged",
                "PlaAccepted",
                "LastSearchIndexRequest",
                "displayScheduleLog",
                "LastAccessedWorkPackageId",
                "LastSearchIndexCompleted",
                "ExperimentalEnhancedPrint",
                "ExperimentalColumnMenu",
                "AutoSaveNamedViews"
            ]
        },
        "settingValue":{
            "maxLength":4000,
            "minLength":1,
            "type":"string",
            "description":"The value of a user setting.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "description":"This entity represents a ApplicationUserSetting object, a unique ApplicationUserSetting object can be identified by the following combinations of the fields.<ul><li>applicationUserSettingId</li><li>applicationUserId,settingName</li>",
    "exampleSetFlag":false
}

Examples

Select an example Batch Update User Preferences

Back to Top

Response

200 Response

A collection of object IDs mapped to a canonical link of the object. For example - {"links":{"1":"https://[host]:[port]/api/restapi/[object]/1","2":"https://[host]:[port]/api/restapi/[object]/2"}}

400 Response

Invalid input for the user preferences service.

Back to Top