Set preference

PUT

/rest/api/3/mypreferences

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.

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢204Returned if the request is successful.

application/json

Body

🟠401Returned if the authentication credentials are incorrect or missing.

🟠404Returned if the key or value is not provided or invalid.

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request PUT 'http:///rest/api/3/mypreferences?key=' \
--header 'Content-Type: application/json' \
--data-raw '"string"'

响应示例

204 - 示例 1

null

修改于 2023-07-12 08:28:12

Get preference

Delete preference