{"_id":"59c7f5cb2e6e2f0010cac5a1","project":"568bdc1483d2061900d86cdc","version":{"_id":"59a72290d61777001b6c42c3","project":"568bdc1483d2061900d86cdc","__v":19,"createdAt":"2017-08-30T20:39:44.453Z","releaseDate":"2017-08-30T20:39:44.453Z","categories":["59a7236e3fe4d90025117c10","59a72eb6cb0db3001b84cfe2","59a734eb757d030019b85af8","59c0243b1b2d07001a9d2b76","59c035e42126e10028effb12","59c06c40df5b3c0010584a13","59c1a5852cabe5002641a3e7","59c2fb00b2b45c0010b7a3d7","59c32ceb9aea850010ac4130","59c32e6e190c90003cb0d12f","59c33affb2b45c0010b7aa23","59c7dfa457bd8200105444dc","59c7e975c50cf30010d712a0","59cffdef0cd4dd0010294d54","59d0622ca91a810032c8f60c","59d06733c1aec60026253065","59d174d44ac471001a07b123","59d5a5e323e6e800103defb2","59ecf1d8ed507c001c52b255"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"0.0.0","version":"0"},"category":{"_id":"59c7e975c50cf30010d712a0","project":"568bdc1483d2061900d86cdc","version":"59a72290d61777001b6c42c3","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-09-24T17:20:53.835Z","from_sync":false,"order":17,"slug":"zones-api","title":"Zones API"},"user":"58cc41f21751ce2f003be3b7","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-09-24T18:13:31.741Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"59a85c5502c545000f08a7a5","results":{"codes":[]},"examples":{"codes":[]},"method":"post","auth":"required","params":[{"_id":"59c7ed16c50cf30010d712e2","ref":"","in":"path","required":true,"desc":"","default":"","type":"string","name":"id"},{"_id":"59c7f564791ca600105b9973","ref":"","in":"path","required":true,"desc":"","default":"","type":"string","name":"itemId"}],"url":"/:id/items/:itemId"},"isReference":false,"order":8,"body":"# Details\n\nCreate a zone item.\n\nItems may be devices, or other nested zones.\n\nAn account token, server token, or user token may be used to run this endpoint.\n\n# Parameters\n\n## path\n\n- id (required): The ID of a zone.\n- itemId (required): The ID of a zone item.\n\n# Responses\n\n## 201\n\n```\n{\n    \"itemId\": \"ZONE-ITEM-ID\"\n}\n```\n\n## 400\n\n- __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.\n- __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.\n\n## 404\n\n- __Zone Not Found:__ This error means that a zone with the given ID was not found, although it existed at some point.\n- __Zone Not Found:__ This error means that a zone with the given ID was not found, although it existed at some point.\n\n# Examples\n\n## HTTP\n\n```\nPOST https://ioe.droplit.io/api/zones/ZONE-ID/items/ITEM-ID HTTP/1.1\nauthorization: TOKEN\n```\n\n## Droplit Console\n\n```\ndroplit zone add-item ZONE-ID ITEM-ID\n```","excerpt":"","slug":"zones-items-create","type":"endpoint","title":"Create a zone item."}

postCreate a zone item.


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
required
string
itemId:
required
string

Documentation

# Details Create a zone item. 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. - itemId (required): The ID of a zone item. # Responses ## 201 ``` { "itemId": "ZONE-ITEM-ID" } ``` ## 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. - __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. ## 404 - __Zone Not Found:__ This error means that a zone with the given ID was not found, although it existed at some point. - __Zone Not Found:__ This error means that a zone with the given ID was not found, although it existed at some point. # Examples ## HTTP ``` POST https://ioe.droplit.io/api/zones/ZONE-ID/items/ITEM-ID HTTP/1.1 authorization: TOKEN ``` ## Droplit Console ``` droplit zone add-item ZONE-ID ITEM-ID ```

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}