---
title: "Set the workspace language for agent defaults"
method: PUT
path: "/agents/preferences"
tags: ["agents"]
---

# Set the workspace language for agent defaults

`PUT /agents/preferences`

## Request

- Base URL: `https://api.mailly.site` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mailly.site/agents/preferences`
- Auth: HTTP bearer

Agents without a custom summary prompt use the default prompt for this language. Custom prompts are not changed.

## Request body

- object
  - `locale` 'zh-CN' | 'en-US'

## Response `200`

Saved

- object
  - `success` boolean, required
  - `summary_locale` string, required

## Other responses

- `400`: Invalid parameters
- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/mailly/apis/mailly-api.md) · [All operations](https://skmtc.dev/mailly/apis/mailly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailly/apis/mailly-api/revisions/1ceb29637301?raw)