ironflow debounce

Inspect and cancel pending debounce entries for functions that collapse rapid-fire events into a single invocation. See the debounce how-to for background.

ironflow debounce <subcommand> [flags]

Subcommands:

Subcommand	Description
list	List pending debounce entries (env-scoped)
cancel	Cancel one pending entry without firing it

ironflow debounce list

List currently-armed debounce entries scoped to the request environment. Platform-scoped credentials see all envs.

ironflow debounce list [flags]

Flags:

Long	Short	Type	Default	Description
--json		bool	false	Output as JSON
--server	-s	string		Server URL (default: IRONFLOW_SERVER_URL or http://localhost:9123)

Examples:

ironflow debounce list
ironflow debounce list --json
ironflow debounce list -s http://localhost:9000

Output columns: FUNCTION_ID, KEY, FIRES_AT, PERIOD_MS, EVENT_ID.

ironflow debounce cancel

Cancel one pending debounce entry by function ID and debounce key. The cancelled entry does not fire; the next event for the same key will start a fresh window.

ironflow debounce cancel <function-id> <debounce-key> [flags]

Flags:

Long	Short	Type	Default	Description
--env		string		Environment ID (default: resolve from entry list if unambiguous)
--server	-s	string		Server URL (default: IRONFLOW_SERVER_URL or http://localhost:9123)

When --env is omitted, the command lists entries and matches uniquely on (function_id, debounce_key). Multiple matches across envs → error, pass --env to disambiguate. Debounce keys containing / or . are handled transparently (base64url encoded by the CLI on the wire).

Examples:

# Resolve env automatically when unambiguous
ironflow debounce cancel my-fn-id user-42

# Explicit env for tenant-scoped clarity
ironflow debounce cancel my-fn-id "build:repo-7" --env env_default

# Keys with special characters round-trip fine
ironflow debounce cancel my-fn-id "key.with.dots"

---