Перейти к документации
CLI

openemail out-of-office

Каждая команда этого пространства имён, с её аргументами, флагами и примерами.

Команды

The automatic reply an address sends while its owner is away: read the replies saved in the workspace, set one for an address or a catch-all with its dates, subject and message, and remove it.

Каждая команда здесь также принимает глобальные флаги, например --json, --profile и --dry-run. Глобальные флаги

openemail out-of-office list

Read out of office replies

Разрешенияsettings:readНужен входПсевдонимыls

Использование

openemail out-of-office list [flags]

Resolves every out of office reply saved in the workspace, by address. With --address the array holds exactly one row, the reply of that address, which reads enabled: false with empty text when none was ever saved.

active says whether the reply is going out right now: it is on, the start has passed and the end has not. An address is one address, such as [email protected], or *@example.com for the catch-all of a domain.

Флаги

--address <value>

One address, such as [email protected], or *@example.com for the catch-all of a domain. Left out, every reply saved in the workspace.

Примеры

openemail out-of-office list
With optional flags
openemail out-of-office list --address [email protected]

Также доступно в

API
GET /out-of-office
TypeScript
outOfOffice.list()
Python
out_of_office.list()
Ruby
out_of_office.list
PHP
outOfOffice->list
Go
OutOfOffice.List
Java
outOfOffice().list
C#
OutOfOffice.ListAsync

openemail out-of-office set

Set an out of office reply

Разрешенияsettings:writeНужен вход

Использование

openemail out-of-office set <address> --message <value> [flags]
openemail out-of-office set <address> --data <json|@file|-> [flags]

Saves the out of office reply of one address, or of a catch-all with *@example.com, replacing whatever was saved. While it is active, each person who writes to the address gets the message once for the whole away period, as a reply in the same thread. Mail that would not alert anyone gets no reply: spam, mail a rule filed away, newsletters and other bulk mail, automatic mail, bounces, blocked senders and the workspace's own addresses. With --contacts-only, only people in the contacts, or people the workspace has written to, are answered.

Leave --starts-at out to start now, or to keep the start of a reply that is already on, and --ends-at out or null to keep it on until it is switched off. Both take a Date or an ISO 8601 string with an offset, and the SDK converts a Date with toISOString(). An address with a reply of its own is never answered by the catch-all. Replies count toward the monthly sends, carry no tracking, and still go out on muted threads.

Аргументы

<address>Обязательно

One address, such as [email protected], or *@example.com for the catch-all of a domain. A key or an app limited to particular addresses or domains reaches only the addresses it holds, and a catch-all only when it holds the domain whole.

Флаги

--message <value>

The reply, as plain text, 1 to 10,000 characters once trimmed. Line breaks are kept. Required, here or in --data.

--subject <value>

The subject of the reply, at most 255 characters. Left out or empty, the reply answers with Re: and the subject received.

По умолчанию""
--enabled

Whether the reply is switched on. Left out, true. false keeps the text and pauses the reply.

По умолчаниюtrue
--starts-at <when>

When the reply starts. Left out or null, now, or the start it already has while the reply is on.

--ends-at <when>

When it stops, later than --starts-at. Left out or null, it stays on until it is switched off.

--contacts-only

Answer only contacts and people the workspace has written to. Left out, false.

По умолчаниюfalse
--data <json|@file|->

The whole body as JSON, inline, from a file with @path, or - for standard input. Flags override its keys.

Примеры

The required values only
openemail out-of-office set [email protected] --message 'I am away until 4 January and will answer when I am back.'
With optional flags
openemail out-of-office set [email protected] --message 'I am away until 4 January and will answer when I am back.' --subject 'Away until 4 January' --contacts-only
Read the whole body from a JSON file
openemail out-of-office set [email protected] --data @out-of-office.json

Также доступно в

API
PUT /out-of-office
TypeScript
outOfOffice.set()
Python
out_of_office.set()
Ruby
out_of_office.set
PHP
outOfOffice->set
Go
OutOfOffice.Set
Java
outOfOffice().set
C#
OutOfOffice.SetAsync

openemail out-of-office clear

Remove an out of office reply

Разрешенияsettings:writeНужен вход
Просит подтверждения

Использование

openemail out-of-office clear <address> [flags]

Removes the saved reply of one address or catch-all, so nothing is answered from it any more. Removing a reply that was never saved changes nothing, which is why the SDK retries this call.

To pause a reply and keep its text, save it with enabled: false through set instead.

Аргументы

<address>Обязательно

One address, such as [email protected], or *@example.com for the catch-all of a domain. A key or an app limited to particular addresses or domains reaches only the addresses it holds, and a catch-all only when it holds the domain whole.

Примеры

openemail out-of-office clear [email protected]
Skip the confirmation, for scripts
openemail out-of-office clear [email protected] --yes

Также доступно в

API
DELETE /out-of-office
TypeScript
outOfOffice.clear()
Python
out_of_office.clear()
Ruby
out_of_office.clear
PHP
outOfOffice->clear
Go
OutOfOffice.Clear
Java
outOfOffice().clear
C#
OutOfOffice.ClearAsync