{"id":3794,"date":"2026-02-03T13:36:00","date_gmt":"2026-02-03T19:36:00","guid":{"rendered":"https:\/\/www.mysmartbots.com\/blog\/?p=3794"},"modified":"2026-02-02T15:23:35","modified_gmt":"2026-02-02T21:23:35","slug":"http-api-inventory-updates","status":"publish","type":"post","link":"https:\/\/www.mysmartbots.com\/blog\/2026\/02\/http-api-inventory-updates\/","title":{"rendered":"HTTP API Inventory Updates"},"content":{"rendered":"\n<div class=\"wp-block-image\"><figure class=\"alignright size-large\"><img loading=\"lazy\" width=\"250\" height=\"195\" src=\"https:\/\/www.mysmartbots.com\/blog\/wp-content\/smartbots\/2026\/01\/Heading-200-x-195-px3.png\" alt=\"\" class=\"wp-image-3796\" \/><\/figure><\/div>\n\n\n\n<p>We\u2019ve 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.<\/p>\n\n\n\n<p><strong><code>inventory_list <\/code>Improvements<\/strong><br>The <code><a href=\"https:\/\/docs.mysmartbots.com\/s\/dev\/doc\/inventory_list-z71e9CPOK6\" data-type=\"URL\" data-id=\"https:\/\/docs.mysmartbots.com\/s\/dev\/doc\/inventory_list-z71e9CPOK6\"><strong>inventory_list<\/strong><\/a> <\/code>action now supports additional optional parameters that allow filtering and searching inventory items directly at the API level:<\/p>\n\n\n\n<ul><li><strong><code>skipnames<\/code><\/strong>: Skips attachments whose names contain the specified substring (case-insensitive).<\/li><li><strong><code>matchnames<\/code><\/strong>: Returns only attachments whose names contain the specified substring (case-insensitive).<\/li><li><strong><code>matchuuid<\/code><\/strong>: Returns only the attachment with the specified UUID.<\/li><\/ul>\n\n\n\n<p>These additions make it possible to search a bot\u2019s inventory and return details only for the items you\u2019re interested in, without additional client-side filtering.<\/p>\n\n\n\n<p><strong>New <code>inventory_list_2<\/code> action<\/strong><br>Alongside these improvements, we\u2019re introducing a new HTTP API action: <strong><code><a href=\"https:\/\/docs.mysmartbots.com\/s\/dev\/doc\/inventory_list_2-AU3CorHF9M\" data-type=\"URL\" data-id=\"https:\/\/docs.mysmartbots.com\/s\/dev\/doc\/inventory_list_2-AU3CorHF9M\">inventory_list_2<\/a><\/code><\/strong>.<\/p>\n\n\n\n<p>This new action supports the same filtering and searching options as <code>list_inventory<\/code>, but returns the results in a cleaner, more structured JSON format that\u2019s easier to consume in modern scripts.<\/p>\n\n\n\n<p><strong>Example response:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"action\": \"inventory_list_2\",\n  \"result\": \"OK\",\n  \"list\": &#091;\n    {\n      \"uuid\": \"12b4eca0-5499-3321-ac14-56e5ecb25e95\",\n      \"name\": \"Instructions Notecard\",\n      \"flags\": \"\",\n      \"assetUuid\": \"719197e1-79bb-a8f8-4901-ccee019982b6\",\n      \"currentPerms\": &#091;\n        \"copy\",\n        \"mod\",\n        \"trans\"\n      ],\n      \"type\": \"Notecard\",\n      \"nextPerms\": &#091;\n        \"copy\",\n        \"mod\",\n        \"trans\"\n      ],\n      \"clothing\": \"\"\n    }\n    \/\/ ...more items\n  ]\n}\n<\/code><\/pre>\n\n\n\n<p><strong>New <code>folder_create<\/code> action<\/strong><br>By customer request, we also added a new action to create folders in the bot&#8217;s inventory: <code><a href=\"https:\/\/docs.mysmartbots.com\/s\/dev\/doc\/folder_create-1hyghBu3sh\" data-type=\"URL\" data-id=\"https:\/\/docs.mysmartbots.com\/s\/dev\/doc\/folder_create-1hyghBu3sh\"><strong>folder_create<\/strong><\/a><\/code>.<\/p>\n\n\n\n<p>Happy scripting!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We\u2019ve 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 ImprovementsThe 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 [&hellip;]<\/p>\n","protected":false},"author":14,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[144,146,73],"tags":[441,180,112],"_links":{"self":[{"href":"https:\/\/www.mysmartbots.com\/blog\/wp-json\/wp\/v2\/posts\/3794"}],"collection":[{"href":"https:\/\/www.mysmartbots.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.mysmartbots.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.mysmartbots.com\/blog\/wp-json\/wp\/v2\/users\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mysmartbots.com\/blog\/wp-json\/wp\/v2\/comments?post=3794"}],"version-history":[{"count":5,"href":"https:\/\/www.mysmartbots.com\/blog\/wp-json\/wp\/v2\/posts\/3794\/revisions"}],"predecessor-version":[{"id":3803,"href":"https:\/\/www.mysmartbots.com\/blog\/wp-json\/wp\/v2\/posts\/3794\/revisions\/3803"}],"wp:attachment":[{"href":"https:\/\/www.mysmartbots.com\/blog\/wp-json\/wp\/v2\/media?parent=3794"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.mysmartbots.com\/blog\/wp-json\/wp\/v2\/categories?post=3794"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.mysmartbots.com\/blog\/wp-json\/wp\/v2\/tags?post=3794"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}