Agent mail

The agent's email contacts: the sender list

Allowed = active, waiting = pending, dropped = blocked. Up to 100, most recently seen first. The legacy GET /contacts still lists Salt-account contacts only.

get/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).

status'active' | 'pending' | 'blocked'

Response

OK.

Changes

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