Alter items that are present in a zone.

Change which items are present in the zone.

Details

Alter items that are present in a zone.

Items may be devices, or other nested zones.

An account token, server token, or user token may be used to run this endpoint.

Parameters

path

  • id (required): The ID of a zone.

body

  • items (optional): The array of items present in a zone.

Responses

200

  • No content returned, only the status code. See the REST API “Standard Responses” page.

400

  • Zone Invalid: The standard error structure defines this error as invalid parameters. In this context, it means that the ID given for a zone was not valid.
  • No Query String Allowed: The standard error structure defines this error as invalid parameters, with additional parameters in the query string. In this context, it means that no query string is allowed at all when calling this endpoint.

404

  • Zone Not Found: This error means that a zone with the given ID was not found, although it existed at some point.

Examples

HTTP

PUT https://ioe.droplit.io/api/zones/ZONE-ID/items HTTP/1.1
authorization: TOKEN
content-type: application/json
{
    "items": []
}

Droplit Console

droplit zone update-items ZONE-ID [ITEM-IDS]

Droplit SDK

droplit.zones.updateItems("ZONE-ID", { "items" : [ "ITEM-ID", ... ] });
Language
Authorization
Header
Click Try It! to start a request and see the response here!