---
title: "Set device language/locale"
method: POST
path: "/devices/{deviceId}/language"
tags: ["Tools/Misc"]
---

# Set device language/locale

`POST /devices/{deviceId}/language`

Sets the device language/locale to the BCP-47 locale in the request body. An optional restart flag applies the change immediately by restarting the zygote instead of waiting for the next reboot.

## Path parameters

- `deviceId` string, required

## Headers

- `X-Device-Display-ID` integer

## Request body

- SetLanguageArgs
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `locale` string, required — BCP-47 locale: a 2–3 letter language tag, optionally followed by a 4-letter script and/or a 2-letter region (e.g. en-US, de-DE, ja-JP, zh-Hans-CN).
  - `restart` boolean — Restart zygote so the locale change takes full effect immediately. Without it, the locale is written but won't fully apply until the next reboot.

## Response `204`

No Content

## Other responses

- `default` — Error

## Changes

- **2026-07-07** `d5d1e5ee8188` — 2 info
  - api tag `Tools/Misc` added
  - api tag `Tools` removed
- **2026-06-29** `3cb3612f45e0` — 1 info
  - endpoint added
- **2026-06-29** `8ea6db3daeac` — 1 breaking
  - api path removed without deprecation
- **2026-05-11** `12719a46e639` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/devices/:deviceId/language/post.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/b6fd8aed4bf4/schema)