# Smart Home Dock Trait Schema

`action.devices.traits.Dock` - This trait is designed for self-mobile devices that can be commanded to return for charging.

By and large, these are currently robotic vacuum cleaners, but this would also apply to some
drones, delivery robots, and other future devices.

## Device ATTRIBUTES

None.

## Device STATES

Entities with this trait may report the following
states as part of the [`QUERY`](https://developers.home.google.com/cloud-to-cloud/intents/query) operation. To learn
more about handling `QUERY` intents, see
[Intent fulfillment](https://developers.home.google.com/cloud-to-cloud/integration/query-execute).

| States | Type | Description |
|---|---|---|
| `isDocked` | *Boolean* | **Required.** Whether the device is connected to the docking station or not. |

#### Examples

*Is my device docked?*

```
{
  "isDocked": true
}
```

## Device COMMANDS

Devices with this trait may respond to the following
commands as part of the [`EXECUTE`](https://developers.home.google.com/cloud-to-cloud/intents/execute) operation. To learn
more about handling `EXECUTE` intents, see
[Intent fulfillment](https://developers.home.google.com/cloud-to-cloud/integration/query-execute#handle_execute_intents).

### `action.devices.commands.Dock`

Dock the device.

#### Parameters

| Parameters | Type | Description |
|---|---|---|
| No properties |||

#### Examples

*Dock my device.*

```
{
  "command": "action.devices.commands.Dock",
  "params": {}
}
```

## Sample utterances

> [!NOTE]
> This is a sample of the utterances supported by this device trait, make sure to also review other [supported languages](https://developers.home.google.com/cloud-to-cloud/traits#supported-languages).

### de-DE

- *Staubsauger* andocken

### en-US

- dock *the vacuum*

### es-ES

- envía *el robot* a la base

### fr-FR

- remets *l'aspirateur robot* sur sa base

### hi-IN

- *रोबोट वैक्यूम* को डॉक करो

### it-IT

- ricarica *l'aspirapolvere*

### ja-JP

- *ロボット掃除機* をドックに戻して

### ko-KR

- *로봇 청소기* 충전기에 연결해 줘

### nl-NL

- *de stofzuiger* opladen

### pt-BR

- faça *o robô aspirador* voltar para o suporte

### sv-SE

- docka *dammsugaren*

## Device ERRORS

See the full list of [errors and exceptions](https://developers.home.google.com/cloud-to-cloud/intents/errors-exceptions).