ironflow topic

Manage developer pub/sub topics: list topics, view statistics, and publish messages.

ironflow topic <subcommand> [flags]

Topics provide lightweight service-to-service messaging without triggering functions. See the Topics guide for full details.

ironflow topic list

List all active developer pub/sub topics.

ironflow topic list [flags]

Flags:

Flag	Short	Type	Default	Description
--server	-s	string	$IRONFLOW_SERVER_URL or http://localhost:9123	Server URL
--json		bool	false	Output as JSON

Output:

NAME              MESSAGES  CONSUMERS
order.processed   42        2
user.signup       15        1

ironflow topic stats

Show detailed statistics for a specific topic.

ironflow topic stats <topic> [flags]

Arguments:

Argument	Required	Description
topic	Yes	Topic name (e.g., order.processed)

Flags:

Flag	Short	Type	Default	Description
--server	-s	string	$IRONFLOW_SERVER_URL or http://localhost:9123	Server URL
--json		bool	false	Output as JSON

Output:

Topic:      order.processed
Messages:   42
Consumers:  2
Lag:        5
First Seq:  1
Last Seq:   42

ironflow topic publish

Publish a message to a developer pub/sub topic.

ironflow topic publish <topic> [flags]

Arguments:

Argument	Required	Description
topic	Yes	Topic name (e.g., order.processed)

Flags:

Flag	Short	Type	Default	Description
--data	-d	string		JSON data to publish
--data-file	-f	string		Path to JSON file with data (- reads stdin)
--idempotency-key		string		Idempotency key for deduplication (max 255 bytes, no whitespace or control characters)
--server	-s	string	$IRONFLOW_SERVER_URL or http://localhost:9123	Server URL

Data can be provided via --data or --data-file. --data-file - reads stdin.

Output:

Published to order.processed (event_id=evt_abc123, seq=43)

Examples:

# List all topics
ironflow topic list
ironflow topic list --json

# View topic statistics
ironflow topic stats order.processed
ironflow topic stats order.processed --json

# Publish a message
ironflow topic publish order.processed --data '{"orderId": "123", "status": "shipped"}'

# Publish from file
ironflow topic publish order.processed --data-file payload.json

# Publish from stdin
echo '{"orderId": "123"}' | ironflow topic publish order.processed --data-file -

# Publish with idempotency key
ironflow topic publish order.processed --data '{"orderId": "123"}' --idempotency-key order-123-shipped

---