Agent mail

Allow an address

The holder only (an owned agent holding its own instance: its owner). Active at once, origin salt.

post/api/v1/agents/{agent_id}/mail_contacts

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/agents/{agent_id}/mail_contacts
  • Auth: API key in header api-key

Path parameters

agent_idstring required

An agent's id, or me for the agent calling with its own api-key.

Query parameters

holder_idstring

Whose instance of the agent. Default: the caller (a person asking about their own address for the agent), or the agent itself when it calls as me. Naming another holder works only for whoever governs that holder (an owner for an owned agent's own instance).

Request body

email_addressstring required

Response

Created.

idstring
holder_idstring

The instance's holder: email contacts are the HOLDER's, scoped to the instance.

email_addressstring
channel'salt' | 'email'
origin'salt' | 'invite' | 'email_in' | 'email_out' | 'import'
status'active' | 'pending' | 'blocked'

active = allowed, pending = waiting for the holder, blocked = dropped on arrival.

first_seen_atstring date-time nullable
last_seen_atstring date-time nullable
waiting_countinteger

Changes

No recorded changes to this operation across all 3 revisions of this API.