mail.update

Update Mail Service Configuration.

Type: object

Call parameters

Type: array
No Additional Items

Tuple Validation

Parameter 1: data

data

Type: object

Mail configuration fields to update.

No Additional Properties

fromemail

Fromemail

Type: string

The sending address that the mail server will use for sending emails.

fromname

Fromname

Type: string

outgoingserver

Outgoingserver

Type: string

Hostname or IP address of the SMTP server used for sending emails.

port

Port

Type: integer

security

Security

Type: enum (of string)

Type of encryption.

Must be one of:

• "PLAIN"
• "SSL"
• "TLS"

smtp

Smtp

Type: boolean

Whether SMTP authentication is enabled and user, pass are required.

user

User

SMTP username.

Any of

• Option 1
• Option 2

Type: string

Type: null

pass

Pass

SMTP password.

Any of

• Option 1
• Option 2

Type: string

Type: null

oauth

Oauth

Any of

• MailEntryOAuth
• EmptyDict
• Option 3

MailEntryOAuth

Type: object
No Additional Properties

provider Required

Provider

Type: string

An email provider, e.g. "gmail", "outlook".

client_id Required

Client Id

Type: string

client_secret Required

Client Secret

Type: string

refresh_token Required

Refresh Token

Type: string

EmptyDict

Type: object

Type: null

Return value

MailEntry

Type: object

The resulting mail configuration.

No Additional Properties

fromemail Required

Fromemail

Type: string

The sending address that the mail server will use for sending emails.

fromname Required

Fromname

Type: string

outgoingserver Required

Outgoingserver

Type: string

Hostname or IP address of the SMTP server used for sending emails.

port Required

Port

Type: integer

security Required

Security

Type: enum (of string)

Type of encryption.

Must be one of:

• "PLAIN"
• "SSL"
• "TLS"

smtp Required

Smtp

Type: boolean

Whether SMTP authentication is enabled and user, pass are required.

user Required

User

SMTP username.

Any of

• Option 1
• Option 2

Type: string

Type: null

pass Required

Pass

SMTP password.

Any of

• Option 1
• Option 2

Type: string

Type: null

oauth Required

Oauth

Any of

• MailEntryOAuth
• EmptyDict
• Option 3

MailEntryOAuth

Type: object
No Additional Properties

provider Required

Provider

Type: string

An email provider, e.g. "gmail", "outlook".

client_id Required

Client Id

Type: string

client_secret Required

Client Secret

Type: string

refresh_token Required

Refresh Token

Type: string

EmptyDict

Type: object

Type: null

id Required

Id

Type: integer

Required roles: ALERT_WRITE