---
title: "Set my language"
method: PUT
path: "/api/v1/users/me/locale"
tags: ["Users"]
---

# Set my language

`PUT /api/v1/users/me/locale`

## Request

- Base URL: `https://app.easyscraper.com`
- URL: `https://app.easyscraper.com/api/v1/users/me/locale`
- Auth: API key in cookie `better-auth.session_token`

Saves the current user's language (`locale`), one of the app's locales, so emails sent outside their own requests (notifications) are written in it. The web app calls it when they switch language. While an admin impersonates the user, it changes nothing, since the choice is the admin's

## Request body

- object
  - `locale` 'en', required

## Response `200`

OK

- object
  - `user` object, required
    - `id` string, uuid, required
    - `name` string, required
    - `email` string, required
    - `emailVerified` boolean, required
    - `image` string, nullable, required
    - `role` string, nullable, required
    - `banned` boolean, nullable, required
    - `banReason` string, nullable, required
    - `banExpires` string, date-time, nullable, required
    - `twoFactorEnabled` boolean, required
    - `onboardedAt` string, date-time, nullable, required
    - `locale` string, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `400`: 400
- `401`: 401
- `429`: 429

## Changes

- **2026-11-02** `a12cef98c52b`: 1 info
  - added the non-success response with the status `400`
- **2026-10-31** `3e642e95991a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/easyscraper/apis/easy-scraper-api/changes/api/v1/users/me/locale/put.md)

---

[API](https://skmtc.dev/easyscraper/apis/easy-scraper-api.md) - [All operations](https://skmtc.dev/easyscraper/apis/easy-scraper-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyscraper/apis/easy-scraper-api/revisions/a12cef98c52b?raw)