All topics contain the <channel> which may be either twin or live.
For the meaning of those two channels see Protocol specification.
Delete a Thing
Deletes the Thing identified by the <namespace> and <thingId> in the topic.
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | / |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | / |
|
| status | code | |
204 |
Success - the Thing was deleted successfully. |
Event
The event emitted by Ditto after a thing was deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | / |
Example: Delete a Thing
Delete all Attributes of a Thing
Deletes all Attributes of a Thing identified by the <namespace> and <thingId> in the topic.
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | /attributes |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | /attributes |
|
| status | code | |
204 |
Success - Attributes were deleted successfully. |
Event
The event emitted by Ditto after the attributes of a thing were deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | /attributes |
Example: Delete Attributes
Delete a single Attribute of a Thing
Delete a specific Attribute identified by the <attributePath> of the Thing.
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | /attributes/<attributePath> |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | /attributes/<attributePath> |
|
| status | code | |
204 |
Success - The Attribute was deleted successfully. |
Event
The event emitted by Ditto after the Attribute of a thing was deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | /attributes/<attributePath> |
Example: Delete a single Attribute
Delete the definition of a Thing
Delete the definition of the Thing.
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | /definition |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | /definition |
|
| status | code | |
204 |
Success - The definition was deleted successfully. |
Event
The event emitted by Ditto after the definition of a thing was deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | /definition |
Example: Delete a single definition
Delete all Features of a Thing
Delete all Features of a Thing identified by identified by the <namespace> and the <thingId> in the topic.
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | /features |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | /features |
|
| status | code | |
204 |
Success - The Features were deleted successfully. |
Event
The event emitted by Ditto after the Features of a Thing were deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | /features |
Example: Delete Features
Delete single Feature of a Thing
Delete a specific Feature (identified by the <featureId> in the path) of a Thing.
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | /features/<featureId> |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | /features/<featureId> |
|
| status | code | |
204 |
Success - the Feature was deleted successfully. |
Event
The event emitted by Ditto after a Feature of a Thing was deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | /features/<featureId> |
Example: Delete a single Feature
Delete Definition of a Feature
Delete the Definition of a Feature (identified by the <featureId> in the path) of the Thing
(identified by the <namespace> and the <thingId> in the topic).
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | /features/<featureId>/definition |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | /features/<featureId>/definition |
|
| status | code | |
204 |
Success - the Definition was deleted successfully. |
Event
The event emitted by Ditto after the Feature Definition of a Thing was deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | /features/<featureId>/definition |
Example: Delete Feature Definition
Delete all Properties of a Feature
Delete all Properties of a Feature (identified by the <featureId> in the path) of the Thing
(identified by the <namespace> and the <thingId> in the topic).
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | /features/<featureId>/properties |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | /features/<featureId>/properties |
|
| status | code | |
204 |
Success - the Properties were deleted successfully. |
Event
The event emitted by Ditto after the Feature Properties of a Thing were deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | /features/<featureId>/properties |
Example: Delete Feature Properties
Delete all desired Properties of a Feature
Delete all desired Properties of a Feature (identified by the <featureId> in the path) of the Thing
(identified by the <namespace> and the <thingId> in the topic).
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | /features/<featureId>/desiredProperties |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | /features/<featureId>/desiredProperties |
|
| status | code | |
204 |
Success - the desired Properties were deleted successfully. |
Event
The event emitted by Ditto after the Feature desired Properties of a Thing were deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | /features/<featureId>/desiredProperties |
Example: Delete Feature Desired Properties
Delete a single Property of a Feature
Delete a specific Property (identified by <propertyPath>) of a Feature (identified by the <featureId> in the path).
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | /features/<featureId>/properties/<propertyPath> |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | /features/<featureId>/properties/<propertyPath> |
|
| status | code | |
204 |
Success - the Property was deleted successfully. |
Event
The event emitted by Ditto after a Feature Property of a Thing was deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | /features/<featureId>/properties/<propertyPath> |
Example: Delete a single Feature Property
Delete a single desired Property of a Feature
Delete a specific Property (identified by <desiredPropertyPath>) of a Feature (identified by the <featureId> in the path).
Command
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
| path | /features/<featureId>/desiredProperties/<desiredPropertyPath> |
Response
| Field | Value | |
|---|---|---|
| topic | <namespace>/<thingName>/things/<channel>/commands/delete |
|
| path | /features/<featureId>/desiredProperties/<desiredPropertyPath> |
|
| status | code | |
204 |
Success - the desired Property was deleted successfully. |
Event
The event emitted by Ditto after a Feature desired Property of a Thing was deleted.
| Field | Value |
|---|---|
| topic | <namespace>/<thingName>/things/<channel>/events/deleted |
| path | /features/<featureId>/desiredProperties/<desiredPropertyPath> |