---
title: "Update your user profile"
method: PATCH
path: "/users/me"
tags: ["Users"]
---

# Update your user profile

`PATCH /users/me`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/users/me`
- Auth: HTTP bearer

## Request body

- object
  - `name` string
  - `photo` string, uri, nullable
  - `timezone` string
  - `phone` string, nullable: null clears it.
  - `locale` 'fr' | 'en' | 'de' | 'es' | 'it' | 'pt-BR' | 'nl' | 'pl' | 'sv' | 'da' | 'tr' | 'ja' | 'ko': Preferred UI/email locale — Settings → Appearance writes it here.

## Response `200`

- User
  - `id` string, uuid, required
  - `name` string, required
  - `email` string, email, required
  - `phone` string, nullable: E.164.
  - `companyId` string, uuid, nullable
  - `photo` string, nullable
  - `timezone` string, required: IANA timezone.
  - `locale` 'fr' | 'en' | 'de' | 'es' | 'it' | 'pt-BR' | 'nl' | 'pl' | 'sv' | 'da' | 'tr' | 'ja' | 'ko', nullable: Preferred UI/email locale. NULL = no preference recorded yet.
  - `banned` boolean: Not returned by GET /users/me (restricted profile).
  - `onboardingEmailsSent` string[]
  - `lastActiveAt` string, date-time, nullable
  - `npsTriggeredAt` string, date-time, nullable
  - `termsAcceptedAt` string, date-time, nullable: First terms acceptance (signup checkbox).
  - `termsVersionId` string, uuid, nullable: Published terms version in force at acceptance (legal_document_versions).
  - `tourSeenAt` string, date-time, nullable: Guided tour finished or skipped. NULL = the web app opens it at next load (first login).
  - `storeyToursSeen` object: Storey (`dashboard` | `projects` | `floor` | `context`) → when its guided tour was finished or skipped. A missing storey = its tour opens the first time the user reaches it.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400`: Validation error / PHONE_INVALID
- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `404`: User not found
- `409`: PHONE_EXISTS

---

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