Messages

Kismet uses an internal messagebus system (an extension of the event bus) for communicating messages from various components to the UI.

The messagebus is used to pass error, status, and debug messages, as well as notifications to the user about detected devices, alerts, etc.

For real-time messages, see the eventbus. The Kismet UI uses a combination of the messages API to load previous content, and the eventbus to receive pushed future messages immediately.

All messages

DESC
Fetch the past 50 messages from the messagebus backlog.
ROLES
readonly
URI
/messagebus/all_messages.json
/messagebus/all_messages.ekjson
/messagebus/all_messages.prettyjson
METHODS
GET

Recent messages

DESC
Return all messages since TIMESTAMP.
ROLES
readonly
URI
/messagebus/last-time/{TIMESTAMP}/messages.json
/messagebus/last-time/{TIMESTAMP}/messages.ekjson
/messagebus/last-time/{TIMESTAMP}/messages.prettyjson
METHODS
GET
URI
PARAMETERS
TIMESTAMP number REQUIRED

Timestamps can be absolute (UNIX epochal) timestamps, or they can be relative negativ numbers, indiciating "number of seconds before now".

You can read more about timestamp handling and how to use it here.

RETURN
JSON list of messages since TIMESTAMP.

All messages (marked)

DESC

The same as /messagebus/all_messages; messages which name something identifying also carry kismet.messagebus.message_marked, the message with those parts marked.

Marked text holds the same text as the plain field, with each part that identifies a device, network, person, or place wrapped in control characters: \u0001 (SOH), the kind, \u0002 (STX), the text, and \u0003 (ETX). The kinds are mac (a MAC address), key (a device key), ssid, name (a device or user name), id (other identifiers such as cell IDs), ip, and loc (a location). Marker characters which appear in untrusted text, such as an SSID, are replaced with the literal text \u0001, \u0002, or \u0003, so markers can’t be forged. Removing the markers gives the plain text exactly. A client which doesn’t recognize a kind should hide that part.

The web UI uses the marked text to censor messages and alerts by kind.

kismet.messagebus.message_string, the existing endpoints, the console, and the logs always hold plain text.

ROLES
readonly
ADDED
API added 2026-11
URI
/messagebus/marked/all_messages.json
/messagebus/marked/all_messages.ekjson
/messagebus/marked/all_messages.prettyjson
METHODS
GET

Recent messages (marked)

DESC
The same as /messagebus/last-time/{TIMESTAMP}/messages, with kismet.messagebus.message_marked as described in the marked messages endpoint.
ROLES
readonly
ADDED
API added 2026-11
URI
/messagebus/marked/last-time/{TIMESTAMP}/messages.json
/messagebus/marked/last-time/{TIMESTAMP}/messages.ekjson
/messagebus/marked/last-time/{TIMESTAMP}/messages.prettyjson
METHODS
GET
URI
PARAMETERS
TIMESTAMP number REQUIRED

Timestamps can be absolute (UNIX epochal) timestamps, or they can be relative negativ numbers, indiciating "number of seconds before now".

You can read more about timestamp handling and how to use it here.

RETURN
JSON list of messages since TIMESTAMP.

Post a message

DESC

Put a message on the message console, for API clients such as helper tools to report what they do. The message goes to the console, the logs and the eventbus like Kismet’s own messages.

Untrusted text in the message can’t forge marked spans; only mac is marked. Messages over the info rate limit are dropped like Kismet’s own.

ROLES
admin
ADDED
API added after 2026-10-R1
URI
/messagebus/post.cmd
METHODS
POST
JSON
PARAMETERS

This endpoint takes additional parameters by using a `POST` request and supplying a JSON document or json form variable.

You can find more information about API parameters here.

msg string REQUIRED

The message, 1 to 512 bytes, with no control characters (no newlines).

source string REQUIRED

Who sent it, shown before the message (source: msg); 1 to 32 letters, digits, -, _ and ..

level string OPTIONAL

info (the default), error or alert.

mac string OPTIONAL

A device MAC address the message is about, as AA:BB:CC:DD:EE:FF. It’s shown after the message in parentheses, and marked as a MAC, so censor mode hides it.

RESPONSES
200
Message posted
500
A parameter is missing, too long, or not allowed