Skip to main content
PUT
Replace the caller's agent email allowlist on their current twin

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Body

application/json
addresses
string[]
required
Example:
twin
string

Optional. The Digital Twin id the list was loaded for (the GET's twin.id; the twin object is accepted too). When it is not the caller's current twin the save is refused with 409 TWIN_CHANGED.

Response

The stored list.

The caller's own agent email allowlist on their current Digital Twin: the exact addresses their agents may email there. SEND_EMAIL checks every recipient (to, cc and bcc) against the list of the session's user on the session's twin; one address off the list and nothing is sent. Empty = the agent can send no email. The list records a person's own approval: both verbs answer only the person signed in themselves — a token minted from an API key, a desktop agent's token, a consent-link token or an administrator acting as the member is refused (403 HUMAN_SIGN_IN_REQUIRED).

success
boolean
addresses
string<email>[]

Lowercase, de-duplicated.

max
integer
Example:

100

twin
object

The Digital Twin this list applies to.