{
  "opencollection": "1.0.0",
  "info": {
    "name": "Facilio REST Assets Items API",
    "version": "5.0.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "x-api-key",
      "value": "{{x-api-key}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Items",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List items",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{region}.facilioapis.com/{app_name}/api/v5/item",
            "params": [
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "Page number (1-based)"
              },
              {
                "name": "pageSize",
                "value": "",
                "type": "query",
                "description": "Records per page (max 200)"
              },
              {
                "name": "select",
                "value": "",
                "type": "query",
                "description": "Comma-separated field names to include in the response"
              },
              {
                "name": "expand",
                "value": "",
                "type": "query",
                "description": "Comma-separated lookup field names to expand on **list** endpoints (max 5).\nExpanded objects follow the same rules as single-record GET (see **Lookup fields in responses** in the API overview).\n"
              },
              {
                "name": "search",
                "value": "",
                "type": "query",
                "description": "Free-text search on the primary field (subject, name, etc.)"
              },
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "Include total record count in response"
              },
              {
                "name": "changed",
                "value": "",
                "type": "query",
                "description": "Delta sync: returns records created/modified after this UTC timestamp"
              },
              {
                "name": "sortBy",
                "value": "",
                "type": "query"
              },
              {
                "name": "sortOrder",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "Item balances per storeroom (read-only). Standard list filters apply (e.g. by `storeRoom`, `itemType`)."
        },
        {
          "info": {
            "name": "Get an item",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{region}.facilioapis.com/{app_name}/api/v5/item/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Record ID"
              },
              {
                "name": "select",
                "value": "",
                "type": "query",
                "description": "Comma-separated field names to include in the response"
              },
              {
                "name": "expand",
                "value": "",
                "type": "query",
                "description": "Comma-separated lookup field names to expand on **list** endpoints (max 5).\nExpanded objects follow the same rules as single-record GET (see **Lookup fields in responses** in the API overview).\n"
              }
            ]
          },
          "docs": "Get an item"
        },
        {
          "info": {
            "name": "Adjust item quantity (non-rotating types)",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{region}.facilioapis.com/{app_name}/api/v5/item/adjustment",
            "params": [
              {
                "name": "executeWorkflows",
                "value": "",
                "type": "query"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Posts an **adjustment increase** or **decrease** via item transactions. **Rotating** item types are rejected.\nIf no item row exists for the given **itemType** + **storeRoom**, one may be created as part of the operation.\nOptional **`executeWorkflows`** query. Requires **UPDATE** on the item module.\n"
        },
        {
          "info": {
            "name": "List bins and on-hand quantities for an item",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{region}.facilioapis.com/{app_name}/api/v5/item/:id/bin",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Item record id (not item type id)."
              }
            ]
          },
          "docs": "Returns bins with quantities for the item id in the path (the same id as `GET /item/{id}`)."
        },
        {
          "info": {
            "name": "Get item field schema",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{region}.facilioapis.com/{app_name}/api/v5/item/metadata",
            "params": [
              {
                "name": "includeAllowedValues",
                "value": "",
                "type": "query",
                "description": "When `true`, the metadata response adds `allowed_values` ([{label, value}]) on every picklist-capable field — `ENUM`, `SYSTEM_ENUM`, `MULTI_ENUM`, `STRING_SYSTEM_ENUM`, and `LOOKUP` fields targeting system picklist modules (status, priority, category, type, ...).\nDefault `false` keeps the original metadata payload (no enrichment, no extra DB calls).\nUse this to discover acceptable write values without round-tripping `GET /picklist/{moduleName}/{fieldName}` for every picklist field.\n"
              }
            ]
          },
          "docs": "Get item field schema"
        }
      ]
    }
  ],
  "bundled": true
}