Agentic
Let agents drive your devices through an API
The Agentic area lets you open up your devices to automation by external agents and tools through a secure API. You create an API project, give it its own credentials, choose which of your devices it may act on and set what it is allowed to do. The project credentials are handled securely and encrypted.
What this view does
- List projects — see all of your API projects in one place, the central hub for managing them.
- Add or edit a project — set the project name (at least three characters) and description, configure the agent’s permissions and select which of your devices it can use.
- Two access modes — a project uses either programmatic API access or direct command-line / terminal access as a shared device; the two are mutually exclusive.
- View credentials — the access key and secret are issued automatically by the backend; for an existing project you view and copy them.
- Delete a project when it is no longer needed.
- Secure credentials — project secrets are encrypted, so sensitive values are never stored in the clear.
Create an API project
- Select Agentic in the left-hand menu.
- Choose Add project.
- Enter a name (at least three characters) and a description for the project.
- Select which of your devices the project may act on and set the agent’s permissions on them — see Set up an API project.
- Save the project. On the first save the backend automatically issues the API-Key and API-Secret — you do not generate or regenerate them yourself.
- Open the saved project to view and copy the key and secret (there is also a helper to create an email with the credentials) and give them to the agent or tool that will use the API.
The same key/secret pair is what another user enters when they add your device as a shared device. The number of agentic projects, sessions per day and command limits depend on your plan; see Licence & billing.
Name, credentials, devices and the full permission model for an API project.
Return to the user manual overview.