# Thing

Type: Thing

Schema: [Thing](https://sourcey-ditto.pages.dev/http-api-doc/models/thing.md)

- `thingId` (required)
  Type: string
  
  Unique identifier representing the thing

- `policyId` (required)
  Type: string
  
  The ID of the policy which controls the access to this thing. policies are managed by resource `/policies/{policyId}`

- `definition` (optional)
  Reference: [Definition](https://sourcey-ditto.pages.dev/http-api-doc/models/definition.md); Type: Definition
  
  A single fully qualified identifier of a definition in the form '<namespace>:<name>:<version>' or a valid HTTP(s) URL
  
  pattern: "([_a-zA-Z0-9\\-.]+):([_a-zA-Z0-9\\-.]+):([_a-zA-Z0-9\\-.]+)"

- `attributes` (optional)
  Reference: [Attributes](https://sourcey-ditto.pages.dev/http-api-doc/models/attributes.md); Type: Attributes
  
  An arbitrary JSON object describing the attributes of a thing.

- `features` (optional)
  Reference: [Features](https://sourcey-ditto.pages.dev/http-api-doc/models/features.md); Type: Features
  
  List of features where the key represents the `featureId` of each feature.
  The `featureId` key must be unique in the list.

- `_revision` (optional)
  Type: string
  
  _(read-only)_ The revision is a counter which is incremented on each modification of a Thing. This field
  is not returned by default but must be selected explicitly.

- `_created` (optional)
  Type: string
  
  _(read-only)_ The created timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on creation
  of a Thing. This field is not returned by default but must be selected explicitly.

- `_modified` (optional)
  Type: string
  
  _(read-only)_ The modified timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on each
  modification of a Thing. This field is not returned by default but must be selected explicitly.

- `_metadata` (optional)
  Type: object
  
  _(read-only)_ The Metadata of the Thing. This field is not returned by default but must be selected explicitly.