Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Developer Tools
Snipeit Skill
Interact with Snipe-IT asset management via REST API. Use when working with assets (hardware), users, licenses, accessories, consumables, components, locatio...
skill openclawclawhub Free
Interact with Snipe-IT asset management via REST API. Use when working with assets (hardware), users, licenses, accessories, consumables, components, locatio...
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.0.0
Provenance
- Publisher
- bivex
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Overview
Snipe-IT REST API returns 200 OK for all valid HTTP requests. Check .status field in response โ "success" or "error". Base URL: $SNIPEIT_URL/api/v1
Core Helper
snipe() { local method="${1:-GET}" local endpoint="$2" local data="${3:-}" local args=( -s -X "$method" -H "Authorization: Bearer $SNIPEIT_API_TOKEN" -H "Accept: application/json" -H "Content-Type: application/json" ) [ -n "$data" ] && args+=(-d "$data") curl "${args[@]}" "${SNIPEIT_URL}/api/v1${endpoint}" | jq . } # Shortcuts snipe_get() { snipe GET "$1"; } snipe_post() { snipe POST "$1" "$2"; } snipe_patch() { snipe PATCH "$1" "$2"; } snipe_put() { snipe PUT "$1" "$2"; } snipe_delete() { snipe DELETE "$1"; }
Assets (Hardware)
# List all assets (with pagination) snipe_get "/hardware?limit=50&offset=0" # Search assets snipe_get "/hardware?search=MacBook&limit=20" # Filter by status label snipe_get "/hardware?status_id=2&limit=50" # Get asset by ID snipe_get "/hardware/42" # Get asset by asset tag snipe_get "/hardware/bytag/ASSET-001" # Get asset by serial number snipe_get "/hardware/byserial/SN123456" # Create asset snipe_post "/hardware" '{ "asset_tag": "ASSET-001", "model_id": 5, "status_id": 2, "name": "MacBook Pro 16", "serial": "SN123456", "location_id": 1, "notes": "Assigned to dev team" }' # Update asset (PATCH = partial update) snipe_patch "/hardware/42" '{ "name": "MacBook Pro 16 (updated)", "status_id": 3, "notes": "Screen replaced" }' # Full update (PUT = replace all fields) snipe_put "/hardware/42" '{ "asset_tag": "ASSET-001", "model_id": 5, "status_id": 2, "name": "MacBook Pro 16", "serial": "SN123456" }' # Delete asset snipe_delete "/hardware/42" # Checkout asset to user snipe_post "/hardware/42/checkout" '{ "checkout_to_type": "user", "assigned_user": 7, "note": "Assigned for remote work", "checkout_at": "2025-01-15", "expected_checkin": "2025-12-31" }' # Checkout asset to location snipe_post "/hardware/42/checkout" '{ "checkout_to_type": "location", "assigned_location": 3, "note": "Conference room setup" }' # Checkout asset to another asset snipe_post "/hardware/42/checkout" '{ "checkout_to_type": "asset", "assigned_asset": 15 }' # Checkin asset snipe_post "/hardware/42/checkin" '{ "note": "Returned after use", "checkin_at": "2025-06-01" }' # Audit asset (confirm location) snipe_post "/hardware/audit" '{ "asset_tag": "ASSET-001", "location_id": 2, "note": "Verified during quarterly audit" }' # Get audit history snipe_get "/hardware/audit/due" snipe_get "/hardware/audit/overdue" # List assets checked out to a user snipe_get "/users/7/assets" # Restore deleted asset snipe_post "/hardware/42/restore" '{}'
Users
# List all users snipe_get "/users?limit=50" # Search users snipe_get "/users?search=john&limit=20" # Get user by ID snipe_get "/users/7" # Get current API user snipe_get "/users/me" # Create user snipe_post "/users" '{ "first_name": "John", "last_name": "Doe", "username": "john.doe", "email": "john.doe@example.com", "password": "SecurePass123!", "password_confirmation": "SecurePass123!", "department_id": 2, "location_id": 1, "employee_num": "EMP-001", "jobtitle": "Developer", "activated": true }' # Update user snipe_patch "/users/7" '{ "department_id": 3, "jobtitle": "Senior Developer" }' # Delete user snipe_delete "/users/7" # Get user's assets snipe_get "/users/7/assets" # Get user's licenses snipe_get "/users/7/licenses" # Get user's accessories snipe_get "/users/7/accessories" # Get user's consumables snipe_get "/users/7/consumables"
Licenses
# List all licenses snipe_get "/licenses?limit=50" # Search licenses snipe_get "/licenses?search=Office&limit=20" # Get license by ID snipe_get "/licenses/3" # Create license snipe_post "/licenses" '{ "name": "Microsoft Office 365", "serial": "XXXXX-XXXXX-XXXXX", "seats": 25, "category_id": 4, "manufacturer_id": 2, "license_email": "it@example.com", "purchase_date": "2025-01-01", "expiration_date": "2026-01-01", "purchase_cost": "299.99", "notes": "Annual subscription" }' # Update license snipe_patch "/licenses/3" '{ "seats": 30, "notes": "Seats increased" }' # Delete license snipe_delete "/licenses/3" # List license seats (who has it checked out) snipe_get "/licenses/3/seats" # Checkout license seat to user snipe_post "/licenses/3/seats/12/checkout" '{ "assigned_to": 7, "note": "Developer license" }' # Checkin license seat snipe_delete "/licenses/3/seats/12/checkin"
Accessories
# List all accessories snipe_get "/accessories?limit=50" # Get accessory by ID snipe_get "/accessories/8" # Create accessory snipe_post "/accessories" '{ "name": "USB-C Hub", "category_id": 5, "manufacturer_id": 3, "qty": 10, "purchase_date": "2025-01-01", "purchase_cost": "49.99", "location_id": 1 }' # Update accessory snipe_patch "/accessories/8" '{"qty": 15}' # Delete accessory snipe_delete "/accessories/8" # Checkout accessory to user snipe_post "/accessories/8/checkout" '{ "assigned_to": 7, "note": "For home office" }' # Checkin accessory snipe_post "/accessories/8/checkin" '{ "note": "Returned" }' # List checked-out accessories snipe_get "/accessories/8/checkedout"
Consumables
# List consumables snipe_get "/consumables?limit=50" # Get consumable by ID snipe_get "/consumables/5" # Create consumable snipe_post "/consumables" '{ "name": "Printer Paper A4", "category_id": 6, "qty": 500, "item_no": "PP-A4-500", "purchase_cost": "9.99", "location_id": 1 }' # Checkout consumable (decrements qty) snipe_post "/consumables/5/checkout" '{ "assigned_to": 7, "note": "For printer" }'
Components
# List components snipe_get "/components?limit=50" # Get component by ID snipe_get "/components/12" # Create component snipe_post "/components" '{ "name": "RAM 16GB DDR4", "category_id": 7, "qty": 20, "serial": "RAM-SN-001", "purchase_cost": "89.99", "location_id": 1 }' # Checkout component to asset snipe_post "/components/12/checkout" '{ "assigned_to": 42, "assigned_qty": 2, "note": "Upgrade" }' # Checkin component snipe_post "/components/12/checkin" '{ "checkin_qty": 2 }'
Locations
# List locations snipe_get "/locations?limit=50" # Get location by ID snipe_get "/locations/1" # Create location snipe_post "/locations" '{ "name": "Kyiv Office", "address": "Khreschatyk 1", "city": "Kyiv", "country": "UA", "currency": "UAH" }' # Update location snipe_patch "/locations/1" '{"name": "Kyiv HQ"}' # Delete location snipe_delete "/locations/1" # Get assets at location snipe_get "/locations/1/assets" # Get users at location snipe_get "/locations/1/users"
Departments
# List departments snipe_get "/departments?limit=50" # Get department by ID snipe_get "/departments/2" # Create department snipe_post "/departments" '{ "name": "Engineering", "location_id": 1, "manager_id": 5 }' # Update / Delete snipe_patch "/departments/2" '{"name": "Engineering & DevOps"}' snipe_delete "/departments/2"
Models
# List models snipe_get "/models?limit=50" # Get model by ID snipe_get "/models/5" # Create model snipe_post "/models" '{ "name": "MacBook Pro 16 M3", "manufacturer_id": 1, "category_id": 1, "model_number": "MBP16-M3-2024", "depreciation_id": 1, "eol": 36 }'
Status Labels
# List all status labels snipe_get "/statuslabels" # Get status label by ID snipe_get "/statuslabels/2" # Create status label snipe_post "/statuslabels" '{ "name": "In Repair", "type": "undeployable", "color": "#ff6600", "show_in_nav": true, "default_label": false }' # Types: deployable | pending | undeployable | archived
Categories
# List categories snipe_get "/categories?limit=50" # Create category snipe_post "/categories" '{ "name": "Laptops", "category_type": "asset", "eula": false, "require_acceptance": false }' # category_type: asset | accessory | consumable | component | license
Manufacturers & Suppliers
# Manufacturers snipe_get "/manufacturers?limit=50" snipe_post "/manufacturers" '{"name": "Apple", "url": "https://apple.com"}' snipe_patch "/manufacturers/1" '{"support_email": "support@apple.com"}' # Suppliers snipe_get "/suppliers?limit=50" snipe_post "/suppliers" '{ "name": "Tech Distributor LLC", "email": "orders@techdist.com", "phone": "+380441234567", "address": "Kyiv, Ukraine" }'
Asset Maintenances
# List maintenances snipe_get "/maintenances?limit=50" # Get maintenance by ID snipe_get "/maintenances/3" # Create maintenance record snipe_post "/maintenances" '{ "asset_id": 42, "supplier_id": 2, "asset_maintenance_type": "Repair", "title": "Screen replacement", "start_date": "2025-06-01", "completion_date": "2025-06-05", "cost": "150.00", "notes": "Cracked screen replaced under warranty", "is_warranty": true }' # Update maintenance snipe_patch "/maintenances/3" '{"completion_date": "2025-06-04", "cost": "120.00"}' # Delete maintenance snipe_delete "/maintenances/3"
Reports & Activity
# Activity log (recent actions) snipe_get "/reports/activity?limit=50" # Filter activity by item type snipe_get "/reports/activity?item_type=App%5CModels%5CAsset&limit=20" # Filter by action type snipe_get "/reports/activity?action_type=checkout&limit=20" # Filter by user snipe_get "/reports/activity?user_id=7&limit=20"
Custom Fields
# List all custom fields snipe_get "/fields" # List fieldsets snipe_get "/fieldsets" # Get fieldset by ID (includes its fields) snipe_get "/fieldsets/2" # Update custom field value on asset (use field's db_column_name) snipe_patch "/hardware/42" '{ "custom_fields": { "_snipeit_purchase_order_1": "PO-2025-001", "_snipeit_warranty_months_2": "36" } }'
Settings
# Get app settings snipe_get "/settings" # List backup files snipe_get "/settings/backups" # Download backup snipe_get "/settings/backups/download/backup-2025-06-01.zip" # Get app version snipe_get "/version"
Full asset onboarding
# 1. Get or create model model_id=$(snipe_get "/models?search=MacBook+Pro+16" | jq '.rows[0].id // empty') # 2. Create asset asset_id=$(snipe_post "/hardware" "{ \"asset_tag\": \"ASSET-$(date +%Y%m%d-%H%M)\", \"model_id\": $model_id, \"status_id\": 2, \"name\": \"MacBook Pro 16\", \"location_id\": 1 }" | jq '.payload.id') echo "Created asset ID: $asset_id" # 3. Checkout to user snipe_post "/hardware/$asset_id/checkout" "{ \"checkout_to_type\": \"user\", \"assigned_user\": 7, \"note\": \"New hire onboarding\" }"
Quarterly audit
# Get all assets overdue for audit snipe_get "/hardware/audit/overdue" | jq '.rows[] | {id, asset_tag, name, last_audit_date}' # Confirm each asset location while IFS= read -r asset_tag; do snipe_post "/hardware/audit" "{ \"asset_tag\": \"$asset_tag\", \"location_id\": 1 }" | jq '{status, messages}' done < asset_tags.txt
License compliance check
# For each license, compare seats vs checked out snipe_get "/licenses?limit=100" | jq '.rows[] | { name, total_seats: .seats, available_seats: .free_seats_count, checked_out: (.seats - .free_seats_count) }'
User offboarding
user_id=7 # Get all assets snipe_get "/users/$user_id/assets" | jq '.rows[] | .id' | while read asset_id; do snipe_post "/hardware/$asset_id/checkin" '{"note": "User offboarding"}' echo "Checked in asset $asset_id" done # Get all accessories snipe_get "/users/$user_id/accessories" | jq '.rows[] | .id' | while read acc_id; do snipe_post "/accessories/$acc_id/checkin" '{"note": "User offboarding"}' done # Deactivate user snipe_patch "/users/$user_id" '{"activated": false}' echo "User $user_id deactivated"
Error Handling
snipe_safe() { local result result=$(snipe "$@") local status=$(echo "$result" | jq -r '.status // "success"') if [ "$status" = "error" ]; then echo "โ Error: $(echo "$result" | jq -r '.messages')" >&2 return 1 fi echo "$result" } # Usage snipe_safe GET "/hardware/42" snipe_safe POST "/hardware/42/checkout" '{"checkout_to_type":"user","assigned_user":7}'
Setup
export SNIPEIT_URL="https://assets.w-w.top" export SNIPEIT_API_TOKEN="your_token_here" Getting API token: Log in โ click your avatar (top right) Manage API Keys โ Create New Token Give it a name โ copy the token Important notes: Always send both Content-Type: application/json AND Accept: application/json API always returns 200 OK โ check .status field for "success" / "error" Use ?limit= and ?offset= for pagination (max 500 per request) Dates format: YYYY-MM-DD Monetary values: string "99.99" not number
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs
- SKILL.md