> ## Documentation Index > Fetch the complete documentation index at: https://docs.lusor.ai/llms.txt > Use this file to discover all available pages before exploring further. # Set a Lusor Phone's language > Sets the phone's system language (and optional region). Answers 202 at once with the change `pending`; read `GET .../language` until `state` is `applied` or `failed`. The phone may restart to apply it. Refused with 409 `phone_busy` while a session or live viewer holds the phone or another change is being applied. ## OpenAPI ````yaml /api-reference/openapi.yaml put /v1/workspaces/{workspaceId}/devices/{deviceId}/language openapi: 3.1.0 info: title: Lusor API version: 0.1.0 description: | Run AI agents on real phones, or drive a phone directly with deterministic actions. ## Authentication Every `/v1/*` endpoint except `GET /v1/health` requires an API key. Create one in the Lusor dashboard under **Settings → API Keys**. A key is shown once and is bound to one workspace. Revoking it there stops it working immediately. Send it in either header: - `X-Api-Key: ` - `Authorization: Bearer ` Because a key is bound to its workspace, `workspaceId` query and body parameters are optional for API-key callers. A request that names a different workspace returns an opaque `404`. ## Runs Use `POST /v1/agents/{id}/turns` to start or continue an agent run. Read the run under `/v1/sessions/{id}`; poll `GET /v1/sessions/{id}/status` or `GET /v1/sessions/{id}/events` for progress. ## Errors Errors are JSON: `{ "error": "", "message": "" }`. A request that fails validation returns `400` in one of two shapes, depending on the endpoint: `{ "error": "validation_error", "details": { ... } }` (direct phone control actions, for example), or `{ "error": "bad_request", "message": "" }` (agent endpoints, for example). Branch on `error`. contact: name: Lusor url: https://lusor.ai license: name: Proprietary url: https://lusor.ai/terms servers: - url: https://api.lusor.ai description: Production security: - ApiKey: [] - BearerAuth: [] tags: - name: Agents description: Persistent agents, the phone each one uses, and their turns (runs). - name: Secrets description: | Secrets saved in a workspace (passwords, sign-in details). A run uses them by name through `secrets`; values never travel in a request. - name: Sessions description: | Run records: list, inspect, stop, and read events and artifacts. Start a run with `POST /v1/agents/{id}/turns`, or without an agent through `POST /v1/workspaces/{workspaceId}/devices/{deviceId}/sessions`. - name: LiveView description: | View-only WebRTC live view of a session's phone: signaling, ICE servers, and stream control. API keys get live view only on the customer's own phone, not on a Lusor Phone. - name: Devices description: | The phones in your workspace, and reads of their current screen and UI tree. - name: DeviceVerbs description: | Direct phone control: deterministic actions (tap, swipe, type, key, clear, back, home, recent, screenshot, apps/start, apps/stop) and chains of them. On a Lusor Phone, API-key calls meter phone minutes. - name: Shell description: | Restricted shell escape hatch. Commands are checked against a denylist and audit-logged. No command output is returned. - name: Datasets description: Lists a run produced, saved as reusable Datasets. - name: Skills description: Reusable automation skills (Markdown documents). - name: PhoneNumbers description: | Workspace phone numbers and their stored SMS messages. Read-only for API keys. - name: Emails description: | Workspace Agent Mail addresses and stored inbound mail. Read-only: there is no compose, reply, or send endpoint, and message bodies are returned as raw plain text without HTML execution, remote asset fetches, or code extraction. - name: Workspaces description: The workspace an API key is bound to. - name: Catalog description: The catalog of apps that can be installed on a Lusor Phone. - name: Health description: Service health check. paths: /v1/workspaces/{workspaceId}/devices/{deviceId}/language: put: tags: - Devices summary: Set a Lusor Phone's language description: | Sets the phone's system language (and optional region). Answers 202 at once with the change `pending`; read `GET .../language` until `state` is `applied` or `failed`. The phone may restart to apply it. Refused with 409 `phone_busy` while a session or live viewer holds the phone or another change is being applied. operationId: setDeviceLanguage parameters: - $ref: '#/components/parameters/WorkspaceIdPath' - $ref: '#/components/parameters/DeviceIdPath' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DeviceLanguageInput' responses: '202': description: The change was accepted content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/DeviceLanguage' required: - data '400': $ref: '#/components/responses/DeviceControlInvalid' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/DeviceControlConflict' '502': $ref: '#/components/responses/DeviceControlUpstream' components: parameters: WorkspaceIdPath: name: workspaceId in: path required: true schema: type: string format: uuid description: Workspace UUID. Caller must have access. DeviceIdPath: name: deviceId in: path required: true schema: type: string description: Device id (paired into the workspace). schemas: DeviceLanguageInput: type: object additionalProperties: false required: - language properties: language: type: string pattern: ^[A-Za-z]{2,3}$ description: ISO 639 language code, e.g. `de`. example: de country: type: string pattern: ^[A-Za-z]{2}$ description: Optional ISO 3166-1 alpha-2 region, e.g. `DE`. example: DE DeviceLanguage: type: object required: - language - country - state - error - inProgress properties: language: type: - string - 'null' country: type: - string - 'null' state: $ref: '#/components/schemas/DeviceControlState' error: $ref: '#/components/schemas/DeviceControlError' inProgress: $ref: '#/components/schemas/DeviceControlInProgress' DeviceControlState: type: - string - 'null' enum: - pending - applied - failed - unknown - null description: | `pending` while the change is applied, then `applied`, `failed` or `unknown`. `null` when no change was ever made. The reported value is the one the phone was actually given: a `failed` or `unknown` change never changes it. `unknown` means the phone may or may not have taken the change. Further changes are refused (`phone_busy`) until support resolves it, so an irreversible advertising-ID reset is never repeated on its own. DeviceControlError: type: - string - 'null' enum: - phone_not_ready - phone_offline - task_failed - task_unconfirmed - dispatch_unconfirmed - device_busy - null description: | Why a change did not apply; `null` otherwise. `phone_not_ready`, `phone_offline`, `task_failed` and `device_busy` are `failed` states and nothing was changed — set the value again to retry. `task_unconfirmed` and `dispatch_unconfirmed` are `unknown` states. DeviceControlInProgress: type: - string - 'null' enum: - language - identity - ad_id_reset - null description: >- The change still being applied, if any. Another change is refused until it settles. ErrorResponse: type: object required: - error - message properties: error: type: string message: type: string responses: DeviceControlInvalid: description: | `language_invalid`, `identity_invalid`, or `identity_prop_refused` (a key that is not one of the identity fields, such as a raw Android property). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: Authentication required or invalid credentials. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Forbidden: description: The caller may not perform this action. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' DeviceControlConflict: description: | Refused; nothing changed. `error` is one of `not_managed_phone` (not a Lusor cloud phone), `phone_busy` (a session, a live viewer, a restart or reset, or another change holds the phone), or `phone_not_ready` (not deployed yet, or removed). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' DeviceControlUpstream: description: | `upstream_error`, or `change_outcome_unknown`: the request timed out and the change may still be applied. Read the setting before retrying. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: ApiKey: type: apiKey in: header name: X-Api-Key description: Workspace API key, created in the dashboard under Settings → API Keys. BearerAuth: type: http scheme: bearer description: >- The same workspace API key, sent as `Authorization: Bearer `. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.