You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
43 lines
1.2 KiB
YAML
43 lines
1.2 KiB
YAML
3 years ago
|
put:
|
||
|
tags:
|
||
|
- users
|
||
|
summary: update user picture or icon background colour
|
||
|
parameters:
|
||
|
- in: path
|
||
|
name: uid
|
||
|
schema:
|
||
|
type: integer
|
||
|
required: true
|
||
|
description: uid of the user
|
||
|
example: 1
|
||
|
requestBody:
|
||
|
content:
|
||
|
application/json:
|
||
|
schema:
|
||
|
type: object
|
||
|
properties:
|
||
|
type:
|
||
|
type: string
|
||
|
description: The source of the picture
|
||
|
enum: ['default', 'uploaded', 'external']
|
||
|
example: default
|
||
|
url:
|
||
|
type: string
|
||
|
description: Only used for `external` type, specifies the source of the external image to use as avatar
|
||
|
example: ''
|
||
|
bgColor:
|
||
|
type: string
|
||
|
description: A hexadecimal colour representation
|
||
|
example: '#ff0000'
|
||
|
responses:
|
||
|
'200':
|
||
|
description: successfully updated user picture
|
||
|
content:
|
||
|
application/json:
|
||
|
schema:
|
||
|
type: object
|
||
|
properties:
|
||
|
status:
|
||
|
$ref: ../../../components/schemas/Status.yaml#/Status
|
||
|
response:
|
||
|
type: object
|