mirror of
https://github.com/NodeBB/NodeBB.git
synced 2025-12-25 18:00:28 +01:00
133 lines
4.7 KiB
YAML
133 lines
4.7 KiB
YAML
get:
|
|
tags:
|
|
- groups
|
|
summary: list groups
|
|
description: This operation returns a list of user groups. The number of groups returned is hardcoded to 15 per page.
|
|
parameters:
|
|
- in: query
|
|
name: 'page'
|
|
schema:
|
|
type: number
|
|
required: false
|
|
description: Used for pagination
|
|
example: '1'
|
|
- in: query
|
|
name: 'sort'
|
|
schema:
|
|
type: string
|
|
enum: ['date', 'count']
|
|
required: false
|
|
description: Changes how the returned groups are sorted. By default, will return groups in alphanumeric order.
|
|
example: 'date'
|
|
responses:
|
|
'200':
|
|
description: user groups successfully listed
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
$ref: ../components/schemas/Status.yaml#/Status
|
|
response:
|
|
type: object
|
|
properties:
|
|
groups:
|
|
type: array
|
|
items:
|
|
allOf:
|
|
- $ref: ../components/schemas/GroupObject.yaml#/GroupDataObject
|
|
- type: object
|
|
properties:
|
|
members:
|
|
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
|
|
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'
|
|
truncated:
|
|
type: boolean
|
|
description: Whether this returned member list is a subset of the total membership
|
|
nextStart:
|
|
type: number
|
|
post:
|
|
tags:
|
|
- groups
|
|
summary: create a new group
|
|
description: This operation creates a new group
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
name:
|
|
type: string
|
|
example: 'My Test Group'
|
|
timestamp:
|
|
type: number
|
|
disableJoinRequests:
|
|
type: number
|
|
enum: [0, 1]
|
|
disableLeave:
|
|
type: number
|
|
enum: [0, 1]
|
|
hidden:
|
|
type: number
|
|
enum: [0, 1]
|
|
example: 1
|
|
ownerUid:
|
|
type: number
|
|
private:
|
|
type: number
|
|
enum: [0, 1]
|
|
description:
|
|
type: string
|
|
userTitleEnabled:
|
|
type: number
|
|
enum: [0, 1]
|
|
createtime:
|
|
type: number
|
|
memberPostCids:
|
|
type: array
|
|
items:
|
|
type: number
|
|
example: [1, 2, 3]
|
|
required:
|
|
- name
|
|
responses:
|
|
'200':
|
|
description: group successfully created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
$ref: ../components/schemas/Status.yaml#/Status
|
|
response:
|
|
$ref: ../components/schemas/GroupObject.yaml#/GroupDataObject |