Skip to main content

signaloid-cli users

Manage user account and settings.

Synopsis​

signaloid-cli users <command> [options]

Description​

The users command group provides commands to view and manage your Signaloid user account, update profile information, view activity logs, and manage active sessions.

Subcommands​

  • me - Display current user information
  • update - Update profile fields and editor preferences
  • customization - View account customization settings
  • logs - View account activity logs
  • logout-all - Logout from all active sessions
  • delete - Delete a user account

Account Information​

View Account Summary​

#!/bin/bash

echo "=== Account Summary ==="
USER_INFO=$(signaloid-cli users me)

echo "Email: $(echo $USER_INFO | jq -r '.Username')"
echo "Tier: $(echo $USER_INFO | jq -r '.Tier')"
echo "Member since: $(echo $USER_INFO | jq -r '.CreatedAt | todate')"
echo ""

echo "=== Recent Activity ==="
signaloid-cli users logs --count 5 | \
  jq -r '.logs[] | "\(.eventType)\t\(.ipAddress)"'

Monitor activity locations​

#!/bin/bash
# Check for activity from unexpected locations

signaloid-cli users logs --count 50 | \
  jq -r '.logs[] | "\(.ipAddress)\t\(.city)\t\(.country)"' | \
  sort | uniq -c | sort -rn

Security Features​

Activity Monitoring​

#!/bin/bash
# Daily activity summary

echo "Activity for $(date -d 'yesterday' +%Y-%m-%d):"

FROM=$(date -d 'yesterday' -u +"%Y-%m-%dT00:00:00Z")
TO=$(date -d 'yesterday' -u +"%Y-%m-%dT23:59:59Z")

signaloid-cli users logs --from $FROM --to $TO | \
  jq -r '.logs[] | .eventType' | \
  sort | uniq -c | sort -rn

Exit Codes​

CodeDescription
0Success
1Error (authentication failed, invalid parameters)

Tips and Tricks​

Export Activity Report​

#!/bin/bash
# Generate monthly activity report

MONTH=$(date +%Y-%m)
FROM="${MONTH}-01T00:00:00Z"
TO="$(date -d "$(date +%Y-%m-01) +1 month -1 day" -u +%Y-%m-%dT23:59:59Z)"

signaloid-cli users logs --from $FROM --to $TO > "activity-${MONTH}.json"

echo "Activity report saved to activity-${MONTH}.json"

# Generate summary
jq -r '.logs[] | .eventType' "activity-${MONTH}.json" | \
  sort | uniq -c | sort -rn > "summary-${MONTH}.txt"

echo "Summary saved to summary-${MONTH}.txt"

Troubleshooting​

"Not authenticated" Error​

Problem: Cannot access user information.

Solutions:

  1. Login first: signaloid-cli auth login
  2. Verify authentication: signaloid-cli auth whoami
  3. Check API key is valid
  4. Ensure not logged out

Empty Logs​

Problem: No activity logs returned.

Solutions:

  1. Expand date range. Without --from, users logs covers only the last 7 days.
  2. Remove limit parameter
  3. Check if account is new
  4. Verify authentication

See Also​

Learn More​

Last updated on