Agent mail

Give a session its own email address

The session's holder only (a non-observer member of a plain 1:1 with an agent). Idempotent: a live address is returned again. Mail to it lands in a mail lane under this session; the sender list stays the instance's. Same random 26-character alias as any tag; stopped addresses do not count toward the tag cap, and an instance can make at most 20 addresses a day. Anyone else, an unknown id or the flag off: the same 404.

post/api/v1/chats/{id}/mail_address

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/chats/{id}/mail_address
  • 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.

idstring required

The session (chat) id.

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

Response

Already had one.

addressstring
tag_idstring

Changes

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