---
updatedAt: 2026-06-15T13:51:20.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/llms.txt
---

# Create Computer Inventory record

Creates Computer Inventory record

> 📋 **Required privilege:** Create Computers

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Jamf Pro API",
    "termsOfService": "https://www.jamf.com/developer-resources/api-license-agreement",
    "version": "11.33.0"
  },
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/api"
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "swift",
      "ruby",
      "python"
    ],
    "explorer-enabled": false
  },
  "security": [
    {
      "Bearer": []
    },
    {
      "ApiClient": []
    },
    {
      "BasicAuth": [
        "/v1/auth/token"
      ]
    }
  ],
  "paths": {
    "/v2/computers-inventory": {
      "post": {
        "tags": [
          "computer-inventory"
        ],
        "summary": "Create Computer Inventory record",
        "description": "Creates Computer Inventory record\n\n> 📋 **Required privilege:** Create Computers",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ComputerInventoryCreateRequestV2"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful response - Computer Inventory record created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HrefResponse"
                }
              }
            }
          }
        },
        "deprecated": true,
        "x-deprecation-date": "2025-11-06",
        "x-required-privileges": [
          "Create Computers"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ComputerApplicationCreate": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true,
            "example": "Microsoft Word"
          },
          "path": {
            "type": "string",
            "nullable": true,
            "example": "/usr/local/app"
          },
          "version": {
            "type": "string",
            "nullable": true,
            "example": "1.0.0"
          }
        }
      },
      "ComputerCertificateCreate": {
        "type": "object",
        "properties": {
          "commonName": {
            "type": "string",
            "nullable": true,
            "example": "jamf.com"
          },
          "identity": {
            "type": "boolean",
            "nullable": true,
            "example": true
          },
          "username": {
            "type": "string",
            "nullable": true,
            "example": "test"
          }
        }
      },
      "ComputerConfigurationProfileCreate": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "example": "1"
          },
          "username": {
            "type": "string",
            "nullable": true,
            "example": "username"
          },
          "lastInstalled": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": "2018-10-31T18:04:13Z"
          },
          "removable": {
            "type": "boolean",
            "nullable": true,
            "example": true
          },
          "displayName": {
            "type": "string",
            "nullable": true,
            "example": "Displayed profile"
          },
          "profileIdentifier": {
            "type": "string",
            "nullable": true,
            "example": "0ae590fe-9b30-11ea-bb37-0242ac130002"
          }
        }
      },
      "ComputerDiskCreate": {
        "type": "object",
        "properties": {
          "device": {
            "type": "string",
            "nullable": true,
            "example": "disk0"
          },
          "model": {
            "type": "string",
            "nullable": true,
            "example": "APPLE HDD TOSHIBA MK5065GSXF"
          },
          "revision": {
            "type": "string",
            "nullable": true,
            "example": "5"
          },
          "serialNumber": {
            "type": "string",
            "nullable": true,
            "example": "a8598f013366"
          },
          "sizeMegabytes": {
            "type": "integer",
            "description": "Disk Size in MB.",
            "format": "int64",
            "nullable": true,
            "example": 262144
          },
          "smartStatus": {
            "type": "string",
            "description": "S.M.A.R.T Status",
            "nullable": true,
            "example": "OK"
          },
          "type": {
            "type": "string",
            "description": "Connection type attribute.",
            "nullable": true,
            "example": "false"
          },
          "partitions": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ComputerPartitionCreate"
            }
          }
        }
      },
      "ComputerGeneralCreate": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "minLength": 1,
            "type": "string",
            "example": "Boalime"
          },
          "lastIpAddress": {
            "type": "string",
            "example": "247.185.82.186"
          },
          "lastReportedIp": {
            "type": "string",
            "example": "247.185.82.186"
          },
          "jamfBinaryVersion": {
            "type": "string",
            "example": "9.27"
          },
          "platform": {
            "type": "string",
            "example": "MAC",
            "enum": [
              "WINDOWS",
              "MAC",
              "NONE"
            ]
          },
          "barcode1": {
            "type": "string",
            "example": "5 12345 678900"
          },
          "barcode2": {
            "type": "string",
            "example": "5 12345 678900"
          },
          "assetTag": {
            "type": "string",
            "example": "304822"
          },
          "remoteManagement": {
            "$ref": "#/components/schemas/ComputerRemoteManagementCreate"
          },
          "supervised": {
            "type": "boolean",
            "example": true
          },
          "mdmCapable": {
            "type": "boolean",
            "example": true
          },
          "reportDate": {
            "type": "string",
            "format": "date-time",
            "example": "2018-10-31T18:04:13Z"
          },
          "lastContactTime": {
            "type": "string",
            "format": "date-time",
            "example": "2018-10-31T18:04:13Z"
          },
          "lastCloudBackupDate": {
            "type": "string",
            "format": "date-time",
            "example": "2018-10-31T18:04:13Z"
          },
          "lastEnrolledDate": {
            "type": "string",
            "format": "date-time",
            "example": "2018-10-31T18:04:13Z"
          },
          "distributionPointId": {
            "type": "string",
            "example": "1"
          },
          "siteId": {
            "type": "string",
            "example": "1"
          },
          "itunesStoreAccountActive": {
            "type": "boolean",
            "example": true
          },
          "enrolledViaAutomatedDeviceEnrollment": {
            "type": "boolean",
            "example": true
          },
          "userApprovedMdm": {
            "type": "boolean",
            "example": true
          },
          "declarativeDeviceManagementEnabled": {
            "type": "boolean",
            "example": true
          }
        }
      },
      "ComputerHardwareCreate": {
        "type": "object",
        "properties": {
          "make": {
            "type": "string",
            "example": "Apple"
          },
          "model": {
            "type": "string",
            "example": "13-inch MacBook Pro (Mid 2012)"
          },
          "modelIdentifier": {
            "type": "string",
            "example": "MacBookPro9,2"
          },
          "serialNumber": {
            "type": "string",
            "example": "C02ZC2QYLVDL"
          },
          "processorSpeedMhz": {
            "type": "integer",
            "description": "Processor Speed in MHz.",
            "format": "int64",
            "example": 2100
          },
          "processorCount": {
            "type": "integer",
            "example": 2
          },
          "coreCount": {
            "type": "integer",
            "example": 2
          },
          "processorType": {
            "type": "string",
            "example": "Intel Core i5"
          },
          "processorArchitecture": {
            "type": "string",
            "example": "i386"
          },
          "busSpeedMhz": {
            "type": "integer",
            "format": "int64",
            "example": 2133
          },
          "cacheSizeKilobytes": {
            "type": "integer",
            "description": "Cache Size in KB.",
            "format": "int64",
            "example": 3072
          },
          "networkAdapterType": {
            "type": "string",
            "example": "Foo"
          },
          "macAddress": {
            "type": "string",
            "example": "6A:2C:4B:B7:65:B5"
          },
          "altNetworkAdapterType": {
            "type": "string",
            "example": "Bar"
          },
          "altMacAddress": {
            "type": "string",
            "example": "82:45:58:44:dc:01"
          },
          "totalRamMegabytes": {
            "type": "integer",
            "description": "Total RAM Size in MB.",
            "format": "int64",
            "example": 4096
          },
          "openRamSlots": {
            "type": "integer",
            "description": "Available RAM slots.",
            "example": 0
          },
          "batteryCapacityPercent": {
            "maximum": 100,
            "minimum": 0,
            "type": "integer",
            "description": "Remaining percentage of battery power.",
            "example": 85
          },
          "batteryHealth": {
            "type": "string",
            "description": "- NON_GENUINE: The battery isn’t a genuine Apple battery.\n- NORMAL: The battery is operating normally.\n- SERVICE_RECOMMENDED: The system recommends battery service.\n- UNKNOWN: The system couldn’t determine battery health information.\n- UNSUPPORTED: The device doesn’t support battery health reporting.\n",
            "enum": [
              "NON_GENUINE",
              "NORMAL",
              "SERVICE_RECOMMENDED",
              "UNKNOWN",
              "UNSUPPORTED"
            ],
            "default": "UNKNOWN"
          },
          "smcVersion": {
            "type": "string",
            "example": "2.2f38"
          },
          "nicSpeed": {
            "type": "string",
            "example": "N/A"
          },
          "opticalDrive": {
            "type": "string",
            "example": "MATSHITA DVD-R UJ-8A8"
          },
          "bootRom": {
            "type": "string",
            "example": "MBP91.00D3.B08"
          },
          "bleCapable": {
            "type": "boolean",
            "example": false
          },
          "supportsIosAppInstalls": {
            "type": "boolean",
            "example": false
          },
          "appleSilicon": {
            "type": "boolean",
            "example": false
          }
        }
      },
      "ComputerInventoryCreateRequestV2": {
        "type": "object",
        "properties": {
          "udid": {
            "type": "string",
            "nullable": true,
            "example": "45436edf-864e-4364-982a-330b01d39e65"
          },
          "general": {
            "$ref": "#/components/schemas/ComputerGeneralCreate"
          },
          "applications": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ComputerApplicationCreate"
            }
          },
          "storage": {
            "$ref": "#/components/schemas/ComputerStorageCreate"
          },
          "security": {
            "$ref": "#/components/schemas/ComputerSecurityCreate"
          },
          "configurationProfiles": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ComputerConfigurationProfileCreate"
            }
          },
          "printers": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ComputerPrinterCreate"
            }
          },
          "services": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ComputerServiceCreate"
            }
          },
          "localUserAccounts": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ComputerLocalUserAccountCreate"
            }
          },
          "certificates": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ComputerCertificateCreate"
            }
          },
          "packageReceipts": {
            "$ref": "#/components/schemas/ComputerPackageReceiptsCreate"
          },
          "softwareUpdates": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ComputerSoftwareUpdateCreate"
            }
          },
          "purchasing": {
            "$ref": "#/components/schemas/ComputerPurchaseCreate"
          },
          "userAndLocation": {
            "$ref": "#/components/schemas/ComputerUserAndLocationCreate"
          },
          "hardware": {
            "$ref": "#/components/schemas/ComputerHardwareCreate"
          },
          "operatingSystem": {
            "$ref": "#/components/schemas/ComputerOperatingSystemCreate"
          }
        }
      },
      "ComputerLocalUserAccountCreate": {
        "type": "object",
        "properties": {
          "uid": {
            "type": "string",
            "nullable": true,
            "example": "501"
          },
          "userGuid": {
            "type": "string",
            "nullable": true,
            "example": "844F1177-0CF5-40C6-901F-38EDD9969C1C"
          },
          "username": {
            "type": "string",
            "nullable": true,
            "example": "jamf"
          },
          "fullName": {
            "type": "string",
            "nullable": true,
            "example": "John Jamf"
          },
          "admin": {
            "type": "boolean",
            "nullable": true,
            "example": true
          },
          "homeDirectory": {
            "type": "string",
            "nullable": true,
            "example": "/Users/jamf"
          },
          "homeDirectorySizeMb": {
            "type": "integer",
            "description": "Home directory size in MB.",
            "format": "int64",
            "nullable": true,
            "example": 131072
          },
          "fileVault2Enabled": {
            "type": "boolean",
            "nullable": true,
            "example": true
          },
          "userAccountType": {
            "type": "string",
            "nullable": true,
            "example": "LOCAL",
            "enum": [
              "LOCAL",
              "MOBILE",
              "UNKNOWN"
            ]
          },
          "passwordMinLength": {
            "type": "integer",
            "nullable": true,
            "example": 4
          },
          "passwordMaxAge": {
            "type": "integer",
            "nullable": true,
            "example": 5
          },
          "passwordMinComplexCharacters": {
            "type": "integer",
            "nullable": true,
            "example": 5
          },
          "passwordHistoryDepth": {
            "type": "integer",
            "nullable": true,
            "example": 5
          },
          "passwordRequireAlphanumeric": {
            "type": "boolean",
            "nullable": true,
            "example": true
          },
          "computerAzureActiveDirectoryId": {
            "type": "string",
            "nullable": true,
            "example": "1"
          },
          "userAzureActiveDirectoryId": {
            "type": "string",
            "nullable": true,
            "example": "1"
          }
        }
      },
      "ComputerOperatingSystemCreate": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true,
            "example": "Mac OS X"
          },
          "version": {
            "type": "string",
            "nullable": true,
            "example": "10.9.5"
          },
          "build": {
            "type": "string",
            "nullable": true,
            "example": "13A603"
          },
          "supplementalBuildVersion": {
            "type": "string",
            "nullable": true,
            "example": "13A953"
          },
          "rapidSecurityResponse": {
            "type": "string",
            "nullable": true,
            "example": "(a)"
          },
          "activeDirectoryStatus": {
            "type": "string",
            "nullable": true,
            "example": "Not Bound"
          },
          "softwareUpdateDeviceId": {
            "type": "string",
            "nullable": true,
            "example": "J132AP"
          }
        }
      },
      "ComputerPackageReceiptsCreate": {
        "type": "object",
        "properties": {
          "installedByJamfPro": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string",
              "example": "com.jamf.protect.JamfProtect"
            }
          },
          "installedByInstallerSwu": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string",
              "example": "com.apple.pkg.Core"
            }
          },
          "cached": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string",
              "example": "com.jamf.protect.JamfProtect"
            }
          }
        },
        "description": "All package receipts are listed by their package name"
      },
      "ComputerPartitionCreate": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true,
            "example": "Foo"
          },
          "sizeMegabytes": {
            "type": "integer",
            "description": "Partition Size in MB.",
            "format": "int64",
            "nullable": true,
            "example": 262144
          },
          "availableMegabytes": {
            "type": "integer",
            "description": "Available space in MB.",
            "format": "int64",
            "nullable": true,
            "example": 131072
          },
          "partitionType": {
            "type": "string",
            "nullable": true,
            "example": "BOOT",
            "enum": [
              "BOOT",
              "RECOVERY",
              "OTHER"
            ]
          },
          "percentUsed": {
            "maximum": 100,
            "minimum": 0,
            "type": "integer",
            "description": "Percentage of space used.",
            "nullable": true,
            "example": 25
          },
          "fileVault2State": {
            "$ref": "#/components/schemas/ComputerPartitionFileVault2State"
          },
          "fileVault2ProgressPercent": {
            "type": "integer",
            "description": "Percentage progress of current FileVault 2 operation.",
            "nullable": true,
            "example": 45
          },
          "lvmManaged": {
            "type": "boolean",
            "nullable": true,
            "example": true
          }
        }
      },
      "ComputerPartitionFileVault2State": {
        "type": "string",
        "example": "ENCRYPTING",
        "enum": [
          "UNKNOWN",
          "UNENCRYPTED",
          "INELIGIBLE",
          "DECRYPTED",
          "DECRYPTING",
          "ENCRYPTED",
          "ENCRYPTING",
          "RESTART_NEEDED",
          "OPTIMIZING",
          "DECRYPTING_PAUSED",
          "ENCRYPTING_PAUSED"
        ]
      },
      "ComputerPrinterCreate": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true,
            "example": "My Printer"
          },
          "type": {
            "type": "string",
            "nullable": true,
            "example": "XYZ 1122"
          },
          "uri": {
            "type": "string",
            "nullable": true,
            "example": "ipp://10.0.0.5"
          },
          "location": {
            "type": "string",
            "nullable": true,
            "example": "7th floor"
          }
        }
      },
      "ComputerPurchaseCreate": {
        "type": "object",
        "properties": {
          "leased": {
            "type": "boolean",
            "nullable": true,
            "example": true
          },
          "purchased": {
            "type": "boolean",
            "nullable": true,
            "example": true
          },
          "poNumber": {
            "type": "string",
            "nullable": true,
            "example": "53-1"
          },
          "poDate": {
            "type": "string",
            "format": "date",
            "nullable": true,
            "example": "2019-01-01"
          },
          "vendor": {
            "type": "string",
            "nullable": true,
            "example": "Example Vendor"
          },
          "warrantyDate": {
            "type": "string",
            "format": "date",
            "nullable": true,
            "example": "2019-01-01"
          },
          "appleCareId": {
            "type": "string",
            "nullable": true,
            "example": "abcd"
          },
          "leaseDate": {
            "type": "string",
            "format": "date",
            "nullable": true,
            "example": "2019-01-01"
          },
          "purchasePrice": {
            "type": "string",
            "nullable": true,
            "example": "$500"
          },
          "lifeExpectancy": {
            "type": "integer",
            "nullable": true,
            "example": 5
          },
          "purchasingAccount": {
            "type": "string",
            "nullable": true,
            "example": "admin"
          },
          "purchasingContact": {
            "type": "string",
            "nullable": true,
            "example": "true"
          }
        }
      },
      "ComputerRemoteManagementCreate": {
        "type": "object",
        "properties": {
          "managed": {
            "type": "boolean",
            "nullable": true,
            "example": true
          }
        }
      },
      "ComputerSecurityCreate": {
        "type": "object",
        "properties": {
          "sipStatus": {
            "type": "string",
            "nullable": true,
            "example": "ENABLED",
            "enum": [
              "NOT_COLLECTED",
              "NOT_AVAILABLE",
              "DISABLED",
              "ENABLED"
            ]
          },
          "gatekeeperStatus": {
            "type": "string",
            "nullable": true,
            "example": "APP_STORE_AND_IDENTIFIED_DEVELOPERS",
            "enum": [
              "NOT_COLLECTED",
              "DISABLED",
              "APP_STORE_AND_IDENTIFIED_DEVELOPERS",
              "APP_STORE"
            ]
          },
          "xprotectVersion": {
            "type": "string",
            "nullable": true,
            "example": "1.2.3"
          },
          "activationLockEnabled": {
            "type": "boolean",
            "nullable": true,
            "example": true
          },
          "recoveryLockEnabled": {
            "type": "boolean",
            "nullable": true,
            "example": true
          },
          "firewallEnabled": {
            "type": "boolean",
            "nullable": true,
            "example": true
          },
          "secureBootLevel": {
            "type": "string",
            "nullable": true,
            "example": "FULL_SECURITY",
            "enum": [
              "NO_SECURITY",
              "MEDIUM_SECURITY",
              "FULL_SECURITY",
              "NOT_SUPPORTED",
              "UNKNOWN"
            ]
          },
          "externalBootLevel": {
            "type": "string",
            "nullable": true,
            "example": "ALLOW_BOOTING_FROM_EXTERNAL_MEDIA",
            "enum": [
              "ALLOW_BOOTING_FROM_EXTERNAL_MEDIA",
              "DISALLOW_BOOTING_FROM_EXTERNAL_MEDIA",
              "NOT_SUPPORTED",
              "UNKNOWN"
            ]
          }
        }
      },
      "ComputerServiceCreate": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true,
            "example": "SomeService"
          }
        }
      },
      "ComputerSoftwareUpdateCreate": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true,
            "example": "BEdit"
          },
          "version": {
            "type": "string",
            "nullable": true,
            "example": "1.15.2"
          },
          "packageName": {
            "type": "string",
            "nullable": true,
            "example": "com.apple.pkg.AdditionalEssentials"
          }
        }
      },
      "ComputerStorageCreate": {
        "type": "object",
        "properties": {
          "disks": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ComputerDiskCreate"
            }
          }
        }
      },
      "ComputerUserAndLocationCreate": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "nullable": true,
            "example": "Madison Anderson"
          },
          "realname": {
            "type": "string",
            "nullable": true,
            "example": "13-inch MacBook"
          },
          "email": {
            "type": "string",
            "nullable": true,
            "example": "email@com.pl"
          },
          "position": {
            "type": "string",
            "nullable": true,
            "example": "IT Team Lead"
          },
          "phone": {
            "type": "string",
            "nullable": true,
            "example": "123-456-789"
          },
          "departmentId": {
            "type": "string",
            "nullable": true,
            "example": "1"
          },
          "buildingId": {
            "type": "string",
            "nullable": true,
            "example": "1"
          },
          "room": {
            "type": "string",
            "nullable": true,
            "example": "5"
          }
        }
      },
      "HrefResponse": {
        "type": "object",
        "properties": {
          "id": {
            "minLength": 1,
            "type": "string",
            "example": "1"
          },
          "href": {
            "type": "string",
            "example": "https://yourJamfProUrl.jamf/api/v1/resource/1"
          }
        }
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      },
      "BasicAuth": {
        "type": "http",
        "description": "Basic auth is used only for obtaining bearer tokens from the /v1/auth/token endpoint",
        "scheme": "basic"
      },
      "ApiClient": {
        "type": "oauth2",
        "description": "Jamf Pro API Roles and Clients provide a client ID and secret for obtaining access tokens using the OAuth2 client_credentials grant type",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "/api/v1/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  }
}
```