51 lines
1.4 KiB
YAML
51 lines
1.4 KiB
YAML
title: Note
|
|
description: >-
|
|
Notes are elements which we can use in association with different resources to
|
|
allow users to describe additional information in relation to these.
|
|
x-resourceId: note
|
|
required:
|
|
- value
|
|
- resource_type
|
|
- resource_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: The note's ID
|
|
example: note_01G8TM8ENBMC7R90XRR1G6H26Q
|
|
resource_type:
|
|
description: The type of resource that the Note refers to.
|
|
type: string
|
|
example: order
|
|
resource_id:
|
|
description: The ID of the resource that the Note refers to.
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
value:
|
|
description: The contents of the note.
|
|
type: string
|
|
example: This order must be fulfilled on Monday
|
|
author_id:
|
|
type: string
|
|
description: The ID of the author (user)
|
|
example: usr_01G1G5V26F5TB3GPAPNJ8X1S3V
|
|
author:
|
|
description: Available if the relation `author` is expanded.
|
|
$ref: ./user.yaml
|
|
created_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was created.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was updated.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
description: The date with timezone at which the resource was deleted.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: An optional key-value map with additional details
|
|
example:
|
|
car: white
|