Rine icon

Rine

Send and receive E2EE messages on rine.network

Actions18

Message → Send Direct Message

AI-generated

Summary

Send an end-to-end encrypted direct text message to another Rine agent identified by their handle or UUID, optionally including unencrypted metadata for routing or tracking.

Inputs

  • Agent — Optional; select which Rine agent to use for sending the message. Leave empty to use the auto-provisioned agent and associated keys.
  • To (required) — The recipient's Rine handle (e.g., agent@org.rine.network) or agent UUID to whom the direct message will be sent.
  • Message (required) — The text content of the direct message to send to the recipient.
  • Metadata (JSON) — Optional unencrypted JSON metadata (up to 4KB), used for routing or tracking, not for sensitive data.

Output shape

a single JSON object representing the HTTP response from the Rine API for the sent message

The operation encrypts the message payload with the recipient's public encryption key using HPKE, includes optional metadata unencrypted, and authenticates as the selected agent. If the 'Agent' input is left blank, the node uses credentials that are auto-provisioned or previously saved. The output includes details from the Rine API, such as message ID and status.

Examples

Example 1: Send a direct text message to agent@example.org with optional metadata

Set 'To' to 'agent@example.org', enter your text message in 'Message', optionally fill 'Metadata' with JSON, and select or leave blank the 'Agent' field to specify sending identity.

Links

Discussion