Skip to main content

device snipeit status

Overview

Checks connectivity to the configured Snipe-IT instance and displays a summary of managed assets. With --verify, performs a full API health check with detailed diagnostics including configuration details.

Usage

device snipeit status [OPTIONS]

Options

OptionDescriptionDefault
--verifyPerform full API health check with detailed diagnosticsfalse

Prerequisites

  • Repo: device-deployments
  • Environment: SNIPEIT_API_KEY must be set
  • Config: Snipe-IT base URL configured (default: https://stuff.selfwize.com)
  • Network: If using Cloudflare Access, cf_client_id and cf_client_secret must be set

Examples

Quick status check

device snipeit status

Full diagnostics

device snipeit status --verify

Output

Displays:

  • Connection status (connected/error)
  • Configured base URL
  • Asset count summary

With --verify:

  • Full configuration details (URL, API key mask, timeout, retries)
  • Detailed connectivity diagnostics

Known Issues

  • --verify may crash on Windows terminals with cp1252 encoding due to Unicode checkmark characters in Rich output.