---
title: "Send key combination"
method: POST
path: "/v1/computer/{machine_id}/input/keyboard/key"
tags: ["computer"]
---

# Send key combination

`POST /v1/computer/{machine_id}/input/keyboard/key`

Send a key combination in XDO-style syntax (e.g., 'ctrl+a', 'alt+tab').

Join keys with `+` to press them together as one chord (e.g. `ctrl+a`); a chord may
combine multiple modifiers (`ctrl`/`alt`/`shift`/`win`) but only one non-modifier key.
Separate keys with spaces to press them one after another (e.g. `down down down`). Using
`+` between repeated or multiple non-modifier keys (e.g. `down+down+down`) is invalid — use
spaces instead (`down down down`).

When `down` is omitted, the key is pressed and released normally. Pass `down=true` to
press and hold the key (without releasing), and `down=false` to release a key that was
previously held.

## Path parameters

- `machine_id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- KeyboardKeyRequest
  - `text` string, required
  - `down` boolean, nullable — None = full press (down + up), True = press key down and hold, False = release a key previously held with down=True

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/cyberdesk-hq/apis/cyberdesk-cloud.md) · [All operations](https://skmtc.net/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cyberdesk-hq/cyberdesk-cloud/versions/830d2f48963d/schema)