Diagnostics

Submit one anonymous allowlisted client diagnostic event

Best-effort unauthenticated ingestion for aggregate setup-funnel counters. Accepts only frozen enum/coarse-version fields, stores no raw event or caller identity, and always returns an empty 204 on success.

post/client-diagnostic-events/v1

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/client-diagnostic-events/v1
  • Auth: none required

Request body

event_idstring uuid required

Fresh random UUID v4 used only for 24-hour deduplication.

event_atstring date-time required
schema_version1 required
flow_version'run402.buzz-doctor.v1' required
event'preflight_started' | 'preflight_passed' | 'preflight_blocked' required
check_name'session_shell' | 'node_runtime' | 'run402_cli' | 'buzz_cli' | 'buzz_agent_target' | 'run402_api' | 'run402_console' | 'buzz_relay' | 'wallet_profile' nullable required
code'BUZZ_PREFLIGHT_SHELL_UNAVAILABLE' | 'BUZZ_PREFLIGHT_NODE_UNAVAILABLE' | 'BUZZ_PREFLIGHT_NODE_INCOMPATIBLE' | 'BUZZ_PREFLIGHT_RUN402_UNAVAILABLE' | 'BUZZ_PREFLIGHT_RUN402_INCOMPATIBLE' | 'BUZZ_PREFLIGHT_RUN402_UPDATE_AVAILABLE' | 'BUZZ_PREFLIGHT_BUZZ_CLI_UNAVAILABLE' | 'BUZZ_PREFLIGHT_BUZZ_CLI_INCOMPATIBLE' | 'BUZZ_AGENT_TARGET_REQUIRED' | 'BUZZ_AGENT_TARGET_UNVERIFIED' | 'BUZZ_AGENT_TARGET_MISMATCH' | 'BUZZ_PREFLIGHT_API_UNREACHABLE' | 'BUZZ_PREFLIGHT_CONSOLE_UNREACHABLE' | 'BUZZ_PREFLIGHT_RELAY_UNSAFE' | 'BUZZ_PREFLIGHT_RELAY_UNREACHABLE' | 'BUZZ_PREFLIGHT_WALLET_PROFILE_REQUIRED' | 'BUZZ_PREFLIGHT_WALLET_PROFILE_NOT_FOUND' | 'BUZZ_PREFLIGHT_WALLET_PROFILE_MISMATCH' | 'null' nullable required
os_family'macos' | 'linux' | 'windows' | 'other' required
node_majorinteger required
run402_majorinteger required
run402_minorinteger required
buzz_fixture_id'buzz-cli-v0.5.2-capabilities' required
install_context'project_local' | 'user_global_npm' | 'ephemeral_exec' | 'managed_buzz_sidecar' | 'custom_path' | 'unknown' required

Response

Event accepted into aggregate counters

Changes

No recorded changes to this operation across all 1 revision of this API.