문서로 건너뛰기
CLI

openemail addresses

이 네임스페이스의 모든 명령과 그 인수, 플래그, 예시.

명령

Which addresses and domains the key may send from.

여기 있는 모든 명령은 --json, --profile, --dry-run 같은 전역 플래그도 받습니다. 전역 플래그 보기

openemail addresses list

List the addresses and domains this key may send as

범위emails:send로그인 필요별칭ls

사용법

openemail addresses list [flags]

Answers the question behind an unexplained 403 from_address_forbidden: which addresses this key may put in from. It returns one page of the addresses created on the workspace's domains, alphabetically, each with a canSend verdict for this key, plus the domains themselves.

unrestricted is true when the key is narrowed by nothing, in which case the API accepts any local-part on the workspace's domains, including ones nobody has created. A key can be narrowed by whole domains, by individual addresses, or by both, and any of those makes unrestricted false. canSend is then true only for an enabled address the key covers, either because its domain is one of the whole domains the key holds or because the address itself is on its address list. A disabled address always reports canSend false.

The SDK reshapes the wire envelope: the server's data array arrives as addresses, so the result is a single object rather than a list.

Add --all to walk every page: a table on a terminal, one JSON object per line when piped or with --ndjson, and one JSON document with --json, shaped as Returns describes. --max <n> stops after that many items.

플래그

--limit <n>

Page size, from 1 to 100. The server defaults to 25.

기본값25
--cursor <value>

The nextCursor of the previous page. Leave it out for the first page.

--all

Fetch every page and stream the items as they arrive.

--max <n>

Stop after this many items. Implies --all.

--ndjson

Print every item as one JSON object per line. Implies --all

예시

openemail addresses list
Walk every page and stop after 100 items
openemail addresses list --all --max 100
One JSON object per line when piped
openemail addresses list --all > addresses.ndjson

다른 사용처

API
GET /addresses
SDK
addresses.list()