リファレンスHTTP APIAuth

Save the signed-in user's language

PATCH
/v1/auth/me

Saves locale (ko, ja or en) on the signed-in user: what user.locale in GET /v1/auth/me returns and the language the user's Slack notices are written in. Slack's ephemeral notices follow the reader's language; a thread's replies and notices follow the language of whoever started the session. A user who never saved one reads English.

Auth: cookie session only; no scope. Idempotency-Key: ignored.

Authorization

cookieSession
cookie__Host-werft_session<token>

For the web console: the browser session cookie set by POST /v1/auth/login. It holds the scopes of the user's workspace role (owner: all; admin and member: all but sessions:recover). Requests other than GET must also send X-Requested-With: werft-web.

Header Parameters

X-Requested-With?"werft-web"

Required with a cookie session: the literal werft-web.

Value in"werft-web"

Request Body

application/json
  1. body
locale*string
Value in"ko""ja""en"

Response Body

The language is saved.

Example Request
curl -X PATCH 'https://example.com/v1/auth/me' \  -H 'Content-Type: application/json' \  -d '{  "locale": "en"}'
Example Response
Empty