Set Preference
PUT {{baseUrl}}/rest/api/3/mypreferences?key=<string>
Creates a preference for the user or updates a preference's value by sending a plain text string. For example, false
. An arbitrary preference can be created with the value containing up to 255 characters. In addition, the following keys define system preferences that can be set or created:
- user.notifications.mimetype The mime type used in notifications sent to the user. Defaults to
html
. - user.notify.own.changes Whether the user gets notified of their own changes. Defaults to
false
. - user.default.share.private Whether new filters are set to private. Defaults to
true
. - user.keyboard.shortcuts.disabled Whether keyboard shortcuts are disabled. Defaults to
false
. - user.autowatch.disabled Whether the user automatically watches issues they create or add a comment to. By default, not set: the user takes the instance autowatch setting.
Note that these keys are deprecated:
- jira.user.locale The locale of the user. By default, not set. The user takes the instance locale.
- jira.user.timezone The time zone of the user. By default, not set. The user takes the instance timezone.
Use Update a user profile from the user management REST API to manage timezone and locale instead.
Permissions required: Permission to access Jira.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
key | string | (Required) The key of the preference. The maximum length is 255 characters. |
Request Body
["<", "s", "t", "r", "i", "n", "g", ">"]
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |