Skip to content

Commit 55197ec

Browse files
committed
changes after review
1 parent 0a8f7e7 commit 55197ec

File tree

3 files changed

+10
-1
lines changed

3 files changed

+10
-1
lines changed

articles/iot-central/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,8 @@
190190
href: core/howto-query-with-rest-api.md
191191
- name: Manage users and roles
192192
href: core/howto-manage-users-roles-with-rest-api.md
193+
- name: Manage organizations
194+
href: core/howto-manage-organizations-with-rest-api.md
193195
- name: Data export
194196
href: core/howto-manage-data-export-with-rest-api.md
195197
- name: Manage device templates

articles/iot-central/core/howto-manage-organizations-with-rest-api.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,9 @@ services: iot-central
1414

1515
The IoT Central REST API lets you develop client applications that integrate with IoT Central applications. You can use the REST API to manage organizations in your IoT Central application.
1616

17+
> [!TIP]
18+
> The [organizations feature](howto-create-organizations.md) is currently available in [preview API](/rest/api/iotcentral/1.1-previewdataplane/users).
19+
1720
Every IoT Central REST API call requires an authorization header. To learn more, see [How to authenticate and authorize IoT Central REST API calls](howto-authorize-rest-api.md).
1821

1922
For the reference documentation for the IoT Central REST API, see [Azure IoT Central REST API reference](/rest/api/iotcentral/).
@@ -56,6 +59,8 @@ The request body has some optional fields:
5659

5760
* `@parent`: ID of the parent of the organization.
5861

62+
If you don't specify a parent, then the organization gets the default top-level organization as it's parent.
63+
5964
The response to this request looks like the following example:
6065

6166
```json
@@ -173,6 +178,8 @@ The response to this request looks like the following example.
173178
}
174179
```
175180

181+
The organizations Washington, Redmond, and Bellevue will automatically have the application's default top-level organization as their parent.
182+
176183
### Delete an organization
177184

178185
Use the following request to delete an organization:

articles/iot-central/core/howto-manage-users-roles-with-rest-api.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -229,4 +229,4 @@ DELETE https://{your app subdomain}.azureiotcentral.com/api/users/user-001?api-v
229229

230230
## Next steps
231231

232-
Now that you've learned how to manage users and roles with the REST API, a suggested next step is to [How to use the IoT Central REST API to manage data exports.](howto-manage-data-export-with-rest-api.md)
232+
Now that you've learned how to manage users and roles with the REST API, a suggested next step is to [How to use the IoT Central REST API to manage organizations.](howto-manage-organizations-with-rest-api.md)

0 commit comments

Comments
 (0)