Skip to content

Messaging

The messaging surface posts to the server's message channel (e.g. for dispatching a command to a specific node by MAC). The SDK exposes one method that mirrors the wire shape — the server defines what payload shapes it accepts per deployment.

Operations

Method What it does
client.messaging.send(*, from_uid=None, **fields) Post a message to /api/v2/messaging.
client.messaging.send(
    from_uid=client.users.me().uid,
    target_mac="aabbccddeeff",
    cmd="ping",
)

The exact fields depend on what your deployment routes via messaging. Returns None on success; raises the standard typed exceptions on failure.

See also

  • Error handling — typed exceptions for message failures.
  • Discrepancy #15/api/v2/messaging replaces the deprecated /api/v2/win_message_que/create.json path the JS reference client uses.