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.
60 lines
2.6 KiB
YAML
60 lines
2.6 KiB
YAML
2 years ago
|
get:
|
||
|
|
tags:
|
||
|
|
- groups
|
||
|
|
summary: get pending users
|
||
|
|
description: This operation lists users that have requested membership to a specific group
|
||
|
|
parameters:
|
||
|
|
- in: path
|
||
|
|
name: slug
|
||
|
|
schema:
|
||
|
|
type: string
|
||
|
|
required: true
|
||
|
|
description: a group slug
|
||
|
|
example: test-group
|
||
|
|
responses:
|
||
|
|
'200':
|
||
|
|
description: pending users successfully retrieved
|
||
|
|
content:
|
||
|
|
application/json:
|
||
|
|
schema:
|
||
|
|
type: object
|
||
|
|
properties:
|
||
|
|
status:
|
||
|
|
$ref: ../../../components/schemas/Status.yaml#/Status
|
||
|
|
response:
|
||
|
|
type: object
|
||
|
|
properties:
|
||
|
|
pending:
|
||
|
|
type: array
|
||
|
|
items:
|
||
|
|
type: object
|
||
|
|
properties:
|
||
|
|
uid:
|
||
|
|
type: number
|
||
|
|
description: A user identifier
|
||
|
|
example: 1
|
||
|
|
username:
|
||
|
|
type: string
|
||
|
|
description: A friendly name for a given user account
|
||
|
|
example: Dragon Fruit
|
||
|
|
userslug:
|
||
|
|
type: string
|
||
|
|
description: An URL-safe variant of the username (i.e. lower-cased, spaces removed, etc.)
|
||
|
|
example: dragon-fruit
|
||
|
|
picture:
|
||
|
|
type: string
|
||
|
|
description: A URL pointing to a picture to be used as the user's avatar
|
||
|
|
example: 'https://images.unsplash.com/photo-1560070094-e1f2ddec4337?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=256&h=256&q=80'
|
||
|
|
nullable: true
|
||
|
|
displayname:
|
||
|
|
type: string
|
||
|
|
description: This is either username or fullname depending on forum and user settings
|
||
|
|
example: Dragon Fruit
|
||
|
|
'icon:text':
|
||
|
|
type: string
|
||
|
|
description: A single-letter representation of a username. This is used in the auto-generated icon given to users without an avatar
|
||
|
|
example: D
|
||
|
|
'icon:bgColor':
|
||
|
|
type: string
|
||
|
|
description: A six-character hexadecimal colour code assigned to the user. This value is used in conjunction with `icon:text` for the user's auto-generated icon
|
||
|
|
example: '#9c27b0'
|