Browse and Create Events¶

How to list, filter, and create device events recorded in the Product Management System.

Events are split into two kinds:

public — externally visible events (e.g. shipping, delivery, activation)
internal — operator-only events (e.g. test results, quality checks)

List recent public events¶

tlm-cli pms events list public

List recent internal events¶

tlm-cli pms events list internal

Filter events¶

Filter by device serial number (fuzzy match — partial values are accepted):

tlm-cli pms events list public --serial "SN-001234"
tlm-cli pms events list internal --serial "SN-001234"

Filter by event type (fuzzy match):

tlm-cli pms events list public --type "shipped"
tlm-cli pms events list internal --type "test"

Combine filters:

tlm-cli pms events list internal --type "qc" --serial "SN-001234"

Navigate the event list¶

Events are fetched in batches of 200 and displayed 25 at a time.

Key	Action
`Enter`	Next page
`D`	Toggle detail view (adds Description, Operator ID, Body JSON)
`Q` or `Esc`	Quit

View events for a specific device¶

When inspecting a single device with tlm-cli pms devices show SN-001234, press D to toggle the detail view — the last 10 public and internal events are shown inline.

Create an event for a device¶

Create a public or internal event for a device interactively. An editor opens to fill in event attributes (event type, date, description, operator ID, and body):

tlm-cli pms events create public --serial SN-001234 --customer ACME
tlm-cli pms events create internal --serial SN-001234 --customer ACME

Both --serial and --customer are required. The device and customer must already exist in the system.