SmartBots Official Blog

We’ve rolled out two important improvements and feature updates to the HTTP API, focused on making inventory access more flexible and easier to work with in scripts.

inventory_list Improvements
The inventory_list action now supports additional optional parameters that allow filtering and searching inventory items directly at the API level:

• skipnames: Skips attachments whose names contain the specified substring (case-insensitive).
• matchnames: Returns only attachments whose names contain the specified substring (case-insensitive).
• matchuuid: Returns only the attachment with the specified UUID.

These additions make it possible to search a bot’s inventory and return details only for the items you’re interested in, without additional client-side filtering.

New inventory_list_2 action
Alongside these improvements, we’re introducing a new HTTP API action: inventory_list_2.

This new action supports the same filtering and searching options as list_inventory, but returns the results in a cleaner, more structured JSON format that’s easier to consume in modern scripts.

Example response:

{
  "action": "inventory_list_2",
  "result": "OK",
  "list": [
    {
      "uuid": "12b4eca0-5499-3321-ac14-56e5ecb25e95",
      "name": "Instructions Notecard",
      "flags": "",
      "assetUuid": "719197e1-79bb-a8f8-4901-ccee019982b6",
      "currentPerms": [
        "copy",
        "mod",
        "trans"
      ],
      "type": "Notecard",
      "nextPerms": [
        "copy",
        "mod",
        "trans"
      ],
      "clothing": ""
    }
    // ...more items
  ]
}

New folder_create action
By customer request, we also added a new action to create folders in the bot’s inventory: folder_create.

Happy scripting!