audiobookshelf/docs/controllers/EmailController.yaml

107 lines
3.0 KiB
YAML
Raw Normal View History

2024-07-04 05:36:01 +02:00
components:
schemas:
emailSettings:
type: string
description: The field to sort by from the request.
example: 'media.metadata.title'
responses:
email200:
description: Successful response - Email
content:
application/json:
schema:
$ref: '../objects/settings/EmailSettings.yaml#/components/schemas/EmailSettings'
ereader200:
description: Successful response - Ereader
content:
application/json:
schema:
type: object
properties:
ereaderDevices:
type: array
items:
$ref: '../objects/settings/EmailSettings.yaml#/components/schemas/EreaderDeviceObject'
paths:
2024-07-04 05:51:54 +02:00
/api/emails/settings:
2024-07-04 05:36:01 +02:00
get:
summary: Get email settings
description: Get email settings for sending e-books to e-readers.
2024-07-04 05:36:01 +02:00
operationId: getEmailSettings
2024-07-04 05:45:04 +02:00
tags:
- Email
2024-07-04 05:36:01 +02:00
responses:
200:
$ref: '#/components/responses/email200'
patch:
summary: Update email settings
operationId: updateEmailSettings
2024-07-04 05:45:04 +02:00
tags:
- Email
2024-07-04 05:36:01 +02:00
requestBody:
required: true
content:
application/json:
schema:
$ref: '../objects/settings/EmailSettings.yaml#/components/schemas/EmailSettings'
2024-07-04 05:36:01 +02:00
responses:
200:
$ref: '#/components/responses/email200'
/api/emails/test:
post:
summary: Send test email
operationId: sendTestEmail
2024-07-04 05:45:04 +02:00
tags:
- Email
2024-07-04 05:36:01 +02:00
responses:
200:
description: Successful response
/api/emails/ereader-devices:
post:
summary: Update e-reader devices
operationId: updateEReaderDevices
2024-07-04 05:45:04 +02:00
tags:
- Email
2024-07-04 05:36:01 +02:00
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
ereaderDevices:
type: array
items:
2024-07-04 05:45:04 +02:00
$ref: '../objects/settings/EmailSettings.yaml#/components/schemas/EreaderDeviceObject'
2024-07-04 05:36:01 +02:00
responses:
200:
$ref: '#/components/responses/ereader200'
400:
description: Invalid payload
/api/emails/send-ebook-to-device:
post:
summary: Send ebook to device
operationId: sendEBookToDevice
2024-07-04 05:45:04 +02:00
tags:
- Email
2024-07-04 05:36:01 +02:00
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
libraryItemId:
$ref: '../objects/LibraryItem.yaml#/components/schemas/libraryItemId'
deviceName:
2024-07-04 05:45:04 +02:00
$ref: '../objects/settings/EmailSettings.yaml#/components/schemas/ereaderName'
2024-07-04 05:36:01 +02:00
responses:
200:
description: Successful response
400:
description: Invalid request
403:
description: Forbidden
404:
description: Not found