Assets

Manage your client's laptops, servers and networking gear with the assets module.

The following information can be recorded for each asset:

• Name
• Type (Desktop/Laptop/Server/Mobile, etc)
• Make/Manufacturer
• Model
• Serial Number
• OS
• IP & MAC addresses
• Status (Prep, deployed, etc)
• Vendor
• Purchase, install, and warranty dates
• Notes

Assets can also be associated with other data in ITFlow, such as:

• Clients
• Locations
• Networks
• Logins
• Tickets
• Services

• You can easily export assets for a client using the Export button.

• You can import a list of assets for a client using the Import button and uploading a CSV
  • Headings: Name, Description, Type, Make, Model, Serial Number, OS, Assigned To, Location

/api/v1/assets

Retrieve asset information - /read.php.

• Default / No params - Returns all assets
• asset_id - Specific asset ID from the ITFlow database
• asset_name - Asset Name
• asset_type - Type of asset (e.g. Laptop, Desktop, Server, etc)
• asset_serial - Asset Serial Number
• client_id - Returns all assets for a specific client

Invoke-RestMethod -Uri "https://demo.itflow.org/api/v1/assets/read.php?api_key=YOUR-API-KEY&asset_id=7" | ConvertTo-Json


{
  "success":  "True",
  "count":  1,
  "data":  [
         {
           "0":  "7",
           "asset_id":  "7",
           "1":  "Laptop",
           "asset_type":  "Laptop",
           "2":  "Sample Laptop",
           "asset_name":  "Sample Laptop",
[...]

Create a new asset - /create.php.

Specify parameters as below. The new asset ID will be returned.

$uri = "https://demo.itflow.org/api/v1/assets/create.php"

$body = @"
{
  "api_key" : "YOUR-API-KEY",
  "asset_name" : "Sample Laptop",
  "asset_type" : "Laptop",
  "asset_make" : "Dell",
  "asset_model" : "Optiplex",
  "asset_serial" : "XYZ",
  "asset_os" : "Win 10",
  "asset_ip" : "",
  "asset_mac" : "",
  "asset_status" : "Deployed",
  "asset_purchase_date" : "0000-00-00",
  "asset_warranty_expire" : "0000-00-00",
  "install_date" : "0000-00-00",
  "asset_notes" : "",
  "asset_vendor_id" : "",
  "asset_location_id" : "",
  "asset_contact_id" : "",
  "asset_network_id" : "",
  "client_id" : "1"
}
"@


Invoke-RestMethod -Method Post -Uri $uri -Body $body

success count data       
------- ----- ----       
True  1   {@{insert_id=41}}

Update attributes of an existing asset - /update.php.

Only parameters specified are changed, remove parameters you don't want to modify. True/False is returned.

$uri = "https://demo.itflow.org/api/v1/assets/update.php"

$body = @"
{
  "api_key" : "YOUR-API-KEY",
  "asset_name" : "Sample Changed Laptop",
  "asset_type" : "Laptop",
  "asset_make" : "Dell",
  "asset_model" : "Optiplex",
  "asset_serial" : "XYZ",
  "asset_os" : "Win 10",
  "asset_ip" : "",
  "asset_mac" : "",
  "asset_status" : "Deployed",
  "asset_purchase_date" : "",
  "asset_warranty_expire" : "",
  "install_date" : "",
  "asset_notes" : "",
  "asset_vendor_id" : "",
  "asset_location_id" : "",
  "asset_contact_id" : "",
  "asset_network_id" : "",
  "client_id" : "1"
}
"@


Invoke-RestMethod -Method Post -Uri $uri -Body $body

success count
------- -----
True    1

Delete an asset - /delete.php.

$uri = "https://demo.itflow.org/api/v1/assets/delete.php"

$body = @"
{
  "api_key" : "YOUR-API-KEY",
  "asset_id" : "10",
  "client_id" : "1"
}
"@


Invoke-RestMethod -Method Post -Uri $uri -Body $body

success count
------- -----
True    1