---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/platform-quickstart.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-quickstart.md
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/platform-quickstart.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/en/llms.txt?revision=r21995741
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/en/llms.txt?revision=r21995741

# Controlling devices over the API

Using the Yandex Smart Home API, you can manage devices of any providers connected to the platform.

To control devices using the Yandex Smart Home API:

1. Register the app on the [Yandex OAuth](https://oauth.yandex.com/client/new/) server. Select your platform and request the necessary permissions for smart home devices (`iot:view`, `iot:control`).
1. Read more about [device types](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-types.md) and their [capabilities](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/capability-types.md).
1. Get familiar with the [programmatic device control protocol](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/platform-protocol.md).
1. Set up logging of the request ID returned in the platform's response in the `request_id`field. You may need it to investigate incidents and problems.

<!-- {% include [support-support-button](../_includes/about/id-support/support-button.md) %}-->