PTC ThingWorx Thing

Schema for a PTC ThingWorx thing (digital twin instance), representing a connected industrial asset or device.

Properties

Name	Type	Description
name	string	Unique thing name in the ThingWorx platform
description	string	Human-readable thing description
thingTemplate	string	Parent thing template that defines property/service/event shape
thingShape	string	Applied thing shape for additional properties or services
tags	array	Model tag vocabulary entries for classification
isEnabled	boolean	Whether the thing is enabled and able to receive data
isSystemObject	boolean	True if this is a built-in ThingWorx system object
identifier	string	External identifier for mapping to physical device or asset
projectName	string	ThingWorx project the thing belongs to
lastModifiedDate	integer	Last modification timestamp (epoch milliseconds UTC)

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.github.io/ptc-thingworx/json-schema/ptc-thingworx-thing-schema.json",
  "title": "PTC ThingWorx Thing",
  "description": "Schema for a PTC ThingWorx thing (digital twin instance), representing a connected industrial asset or device.",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Unique thing name in the ThingWorx platform"
    },
    "description": {
      "type": "string",
      "description": "Human-readable thing description"
    },
    "thingTemplate": {
      "type": "string",
      "description": "Parent thing template that defines property/service/event shape"
    },
    "thingShape": {
      "type": "string",
      "description": "Applied thing shape for additional properties or services"
    },
    "tags": {
      "type": "array",
      "description": "Model tag vocabulary entries for classification",
      "items": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "vocabulary": { "type": "string" }
        }
      }
    },
    "isEnabled": {
      "type": "boolean",
      "description": "Whether the thing is enabled and able to receive data"
    },
    "isSystemObject": {
      "type": "boolean",
      "description": "True if this is a built-in ThingWorx system object"
    },
    "identifier": {
      "type": "string",
      "description": "External identifier for mapping to physical device or asset"
    },
    "projectName": {
      "type": "string",
      "description": "ThingWorx project the thing belongs to"
    },
    "lastModifiedDate": {
      "type": "integer",
      "format": "int64",
      "description": "Last modification timestamp (epoch milliseconds UTC)"
    }
  },
  "required": ["name", "thingTemplate"],
  "examples": [
    {
      "name": "CNC_Machine_Line3_Station7",
      "description": "CNC Machining Center - Production Line 3, Station 7",
      "thingTemplate": "GenericThingTemplate",
      "thingShape": "CNCMachineShape",
      "tags": [
        { "name": "CNC", "vocabulary": "MachineType" },
        { "name": "Line3", "vocabulary": "ProductionLine" }
      ],
      "isEnabled": true,
      "isSystemObject": false,
      "identifier": "ASSET-CNC-LINE3-007",
      "projectName": "SmartFactoryProject"
    }
  ]
}