kanbanworkflowstimelinescrumrubyroadmapproject-planningproject-managementopenprojectangularissue-trackerifcgantt-chartganttbug-trackerboardsbcf
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
167 lines
5.4 KiB
167 lines
5.4 KiB
# /api/v3/my_preferences
|
|
---
|
|
get:
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/hal+json:
|
|
examples:
|
|
response:
|
|
value:
|
|
_links:
|
|
self:
|
|
href: "/api/v3/my_preferences"
|
|
user:
|
|
href: "/api/v3/users/1"
|
|
title: "John Sheppard"
|
|
updateImmediately:
|
|
href: "/api/v3/users/3/preferences"
|
|
method: "patch"
|
|
_type: "UserPreferences"
|
|
commentSortDescending: true
|
|
hideMail: false
|
|
timeZone: "Europe/Berlin"
|
|
warnOnLeavingUnsaved: true
|
|
notifications:
|
|
watched: false
|
|
involved: true
|
|
mentioned: false
|
|
newsAdded: false,
|
|
newsCommented: false
|
|
documentAdded: false
|
|
forumMessages: false
|
|
wikiPageAdded: false
|
|
wikiPageUpdated: false
|
|
membershipAdded: false
|
|
membershipUpdated: false
|
|
workPackageCommented: false
|
|
workPackageProcessed: false
|
|
workPackagePrioritized: false
|
|
workPackageScheduled: false
|
|
_links:
|
|
project:
|
|
href: null
|
|
schema:
|
|
"$ref": "../components/schemas/user_preferences_model.yml"
|
|
description: OK
|
|
headers: {}
|
|
'401':
|
|
content:
|
|
application/hal+json:
|
|
examples:
|
|
response:
|
|
value:
|
|
_type: Error
|
|
errorIdentifier: urn:openproject-org:api:v3:errors:Unauthenticated
|
|
message: You need to be authenticated to access this resource.
|
|
description: Returned if no user is currently authenticated
|
|
headers: {}
|
|
tags:
|
|
- UserPreferences
|
|
description: ''
|
|
operationId: Show_my_preferences
|
|
summary: Show my preferences
|
|
patch:
|
|
responses:
|
|
'200':
|
|
content:
|
|
application/hal+json:
|
|
examples:
|
|
response:
|
|
value:
|
|
_links:
|
|
self:
|
|
href: "/api/v3/my_preferences"
|
|
user:
|
|
href: "/api/v3/users/1"
|
|
title: John Sheppard
|
|
updateImmediately:
|
|
href: "/api/v3/users/3/preferences"
|
|
method: "patch"
|
|
_type: UserPreferences
|
|
commentSortDescending: true
|
|
hideMail: false
|
|
timeZone: Europe/Berlin
|
|
warnOnLeavingUnsaved: true
|
|
notifications:
|
|
watched: false
|
|
involved: true
|
|
mentioned: false
|
|
newsAdded: false,
|
|
newsCommented: false
|
|
documentAdded: false
|
|
forumMessages: false
|
|
wikiPageAdded: false
|
|
wikiPageUpdated: false
|
|
membershipAdded: false
|
|
membershipUpdated: false
|
|
workPackageCommented: false
|
|
workPackageProcessed: false
|
|
workPackagePrioritized: false
|
|
workPackageScheduled: false
|
|
_links:
|
|
project:
|
|
href: null
|
|
schema:
|
|
"$ref": "../components/schemas/user_preferences_model.yml"
|
|
description: OK
|
|
headers: {}
|
|
'400':
|
|
content:
|
|
application/hal+json:
|
|
examples:
|
|
response:
|
|
value:
|
|
_type: Error
|
|
errorIdentifier: urn:openproject-org:api:v3:errors:InvalidRequestBody
|
|
message: The request body was not a single JSON object.
|
|
description: Occurs when the client did not send a valid JSON object in the
|
|
request body.
|
|
headers: {}
|
|
'401':
|
|
content:
|
|
application/hal+json:
|
|
examples:
|
|
response:
|
|
value:
|
|
_type: Error
|
|
errorIdentifier: urn:openproject-org:api:v3:errors:Unauthenticated
|
|
message: You need to be authenticated to access this resource.
|
|
description: Returned if no user is currently authenticated
|
|
headers: {}
|
|
'422':
|
|
content:
|
|
application/hal+json:
|
|
examples:
|
|
response:
|
|
value:
|
|
_type: Error
|
|
errorIdentifier: urn:openproject-org:api:v3:errors:PropertyConstraintViolation
|
|
message: Time zone is not set to one of the allowed values.
|
|
description: |-
|
|
Returned if the update contains invalid properties.
|
|
Reasons are:
|
|
|
|
* Specifying an invalid type
|
|
|
|
* Using an unknown time zone
|
|
headers: {}
|
|
tags:
|
|
- UserPreferences
|
|
description: When calling this endpoint the client provides a single object, containing
|
|
the properties that it wants to change, in the body.
|
|
operationId: Update_UserPreferences
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
example:
|
|
autoHidePopups: true
|
|
timeZone: Europe/Paris
|
|
properties:
|
|
autoHidePopups:
|
|
type: boolean
|
|
timeZone:
|
|
type: string
|
|
type: object
|
|
summary: Update my preferences
|
|
|