API Reference

Our Use Cases and Workflow section provides you with examples as to how some of our API calls are used. Your flow may require additional (or other) calls. Please don't hesitate to reach out to our Implementations team should you find that you need more assistance.

We'll be referencing some of Asset Panda's, "out-of-the-box" groups in our examples. (Yours may vary.)

You can try any of these calls yourself within our V3 API's Public section. You'll first need your API Bearer token (key), so make sure you grab that first!

Examples

You work at Super Heroes, Inc. and find yourself desperately trying to contain your excitement. (It's the weekend and you know you'll likely help to save the world in one way or the other, but that's not all.)

Let's grab our capes and lift off!

Enter a new asset

You've just received a brand new laptop and need to get it into your list of inventory so that you can track the entire lifecycle. This lifecycle includes the purchase date, maintenance information, who it's assigned to and when, where it's at, and so forth. (We're going to be using our Assets group for this example.)

The following calls will help you to create a record for the laptop:

  1. View your list of existing groups. This call gives you the ID, name, etc. of your Assets group.

📘

GET https://api.assetpanda.com/v3/groups

  1. Use your Assets group ID to create a record for your laptop. This is where you'll enter all of the details about your laptop (make, model, where you purchased it, warranty information, serial #, etc.).

📘

POST https://api.assetpanda.com/v3/groups/{group_id}/objects

Create a new action

Actions are a really big part of the overall picture because they keep you up-to-date on the status of your laptop, tracking where it is at any given time. (For instance, whether it's checked out, out for maintenance, who it's assigned to, and so forth.)

You have decided to check this new laptop out to Wonder Woman. (She's heading out on a really big sales call and you want her to have the best of the best when it comes to your equipment.) This requires an action because it needs to be tracked within the system so you (and everyone else) knows that it's checked out to Wonder Woman.

  1. Use your Assets group ID to view the list of existing actions for your Assets group. (You want to check out the laptop, so are looking for a Checked Out action.)


📘

GET https://api.assetpanda.com/v3/groups/{group_id}/actions

Let's say that you find that a Checked Out action does not yet exist for the Assets group.

  1. Use the Assets group ID to create a new, Checked Out action so that you can check out the laptop to Wonder Woman (and eventually others who may also need to use this laptop).

📘

POST https://api.assetpanda.com/v3/groups/{group_id}/actions



User Permissions



Okay, so now you've created the action you need, along with your fields but as you checked the laptop out to Wonder Woman, you also decided that you want to make her an administrator but....
  1. Let's run a list of your current employees so that you can add Woman Woman by duplicating one of your administrator's templates. (No need to start from scratch when you've got the option to duplicate.)

📘

GET https://api.assetpanda.com/v3/users

  1. You'll now create a user account for Wonder Woman.

📘

POST https://api.assetpanda.com/v3/users

Wonder Woman is now set up in the system as an admin. (Just so you know, you copied Captain America's template, who also happened to be one of your administrators.)

In the meantime, you also just received a shipment of brand new laptops. (In fact, these are so nice that you might even assign one of these to yourself. You've earned it!)