funkwhale/docs/specs/collections/schema.yml

54 lines
1.3 KiB
YAML

SimpleCollection:
type: object
required:
- guid
- name
- local
- owner
properties:
guid:
type: string
format: uuid
description: "The globally unique ID of the collection"
name:
type: string
description: "The user-defined name of the collection"
local:
type: boolean
description: "Whether the collection is hosted on the server the request is made against"
owner:
$ref: "../../schema.yml#/components/schemas/SimpleActor"
Collection:
allOf:
- $ref: "#/SimpleCollection"
- type: object
required:
- items
properties:
description:
type: string
description: "The user-defined description of the collection"
recordingCount:
type: integer
description: "The total number of items in the collection"
NewCollection:
type: object
required:
- name
properties:
name:
type: string
description: "The new name for the collection"
description:
type: string
description: "The new description for the collection"
UpdateCollection:
type: object
properties:
name:
type: string
description: "The new name for the collection"
description:
type: string
description: "The new description for the collection"