# JSM Assets Automation Scripts

Python scripts to manage Jira Service Management Assets via API.

How to find the WorkspaceID:
Get https://xxx.atlassian.net/rest/servicedeskapi/assets/workspace

## Quick Start

**1. Install Python dependencies:**

pip install requests


**2. Configure:**

cp config.example.py config.py


Edit `config.py` with your Jira details:
python
BASE_URL = "https://your-domain.atlassian.net"
EMAIL = "your-email@example.com"
API_TOKEN = "your-api-token"
WORKSPACE_ID = "your-workspace-id"


Get your API token: https://id.atlassian.com/manage-profile/security/api-tokens

## Scripts

### Get Assets from a Ticket

# Show asset details
python3 assets.py SD-119253

# Export to CSV
python3 assets.py SD-119253 --csv


Shows: Name, MAC Address, Serial Number, Asset Tag, Status

### Check Free Kiosks (Stock Control)

python3 check_free_kiosks.py


Shows inventory by status (Free, In Use, Retired, etc.)

### Create Assets from CSV

python3 create_assets.py kiosks.csv


CSV format (use `kiosks_template.csv`):

Name,MAC Address,Serial Number,Asset Tag,Status
Kiosk01,AA:BB:CC:DD:EE:01,SN123456,40001,Free


## Troubleshooting

**401 Error:** Check your API token in `config.py`

**404 Error:** Verify `WORKSPACE_ID` (find it in any Asset URL)

**No assets found:** Make sure assets are linked to the ticket in Jira

## What These Scripts Do

1. **Extract asset details** from JSM tickets (MAC addresses, serial numbers, etc.)
2. **Export to CSV** for reports and records
3. **Stock control** - see what's available vs in use
4. **Bulk create** assets from spreadsheets

## Need Help?

Contact: mjurdyga@gmail.com