---
title: "Update the caller's profile shadow"
description: "Sparse PATCH over public.users — display_name, avatar_url, and accent_hue, self-scoped by RLS."
api_method: PATCH
api_path: "/v1/me"
canonical_url: https://wiblo.app/docs/developers/api/identity/update-me
last_updated: 2026-08-25T13:42:39+02:00
md_url: https://wiblo.app/docs/developers/api/identity/update-me.md
---

# Update the caller's profile shadow

`PATCH /v1/me`

Sparse PATCH over `public.users` — `display_name`, `avatar_url`, and `accent_hue`, self-scoped by RLS. Omitted fields stay untouched; `null` clears the clearable ones (`avatar_url`, `accent_hue`). The profile is what seeds the owner identity of workspaces created later and paints the caller's own tile outside any workspace (the onboarding topbar); inside a workspace the shell shows the caller's member row instead. `apply_to` (`"all"` or an array of workspace ids) also writes the new `display_name` (as `name`) and `avatar_url` onto the caller's own member rows in those workspaces, in the same transaction, and the response's `applied` names every row reached; accent and login email never propagate. The login email is not here: changing it is an auth flow, not a profile field. Per-user rate-limited at 30/min.

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `display_name` | `string` | No |  |
| `avatar_url` | `string \| null` | No | `null` clears the photo back to the initial-on-colour tile. |
| `accent_hue` | `"red" \| "coral" \| "orange" \| "green" \| "teal" \| "blue" \| ...` | No | The person's default monogram key; `null` returns the tile to the user-id hash. Seeds the owner member row of workspaces created after the change. |
| `apply_to` | `ProfileApplyTarget` | No |  |

## Request

**curl**

```bash
curl https://api.wiblo.app/v1/me \
  -X PATCH \
  -H "Authorization: Bearer $WIBLO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "display_name": "...",
  "avatar_url": "...",
  "accent_hue": "red"
}'
```

**TypeScript**

```ts
import { createSdk, updateMe } from "@workspace/sdk"

const sdk = createSdk({ baseUrl: "https://api.wiblo.app" })

const { data, error } = await updateMe({
  client: sdk,
  body: {
    "display_name": "...",
    "avatar_url": "...",
    "accent_hue": "red"
  },
})
```

## Responses

**`200`** — The updated profile, in the GET /v1/me shape, plus `applied`: the member rows `apply_to` wrote (empty when it was omitted). Returns `UpdateMeResponse`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | Yes |  |
| `email` | `string \| null` | Yes |  |
| `profile` | `MeProfile` | Yes |  |
| `applied` | `array<AppliedPersona>` | Yes |  |

**`400`** — Body failed Zod validation (`VALIDATION_FAILED`) — unknown field, blank display_name, bad URL, an unknown accent key, or `apply_to` with neither display_name nor avatar_url. Returns `ApiErrorEnvelope`.

**`401`** — No valid Supabase session cookie was present. Returns `ApiErrorEnvelope`.

**`404`** — `apply_to` named a workspace the caller is not an active linked member of (`WORKSPACE_NOT_FOUND`); nothing was written. Returns `ApiErrorEnvelope`.

**`429`** — Rate limit exceeded. The body's `error.code` is `RATE_LIMITED` and `error.details.retry_after` is the same number of seconds as the `Retry-After` header. Returns `ApiErrorEnvelope`.

### The MeProfile object

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `display_name` | `string \| null` | Yes |  |
| `avatar_url` | `string \| null` | Yes |  |
| `accent_hue` | `"red" \| "coral" \| "orange" \| "green" \| "teal" \| "blue" \| ...` | Yes | Stored accent key; `null` means the monogram derives its colour from the user id hash. |

### The AppliedPersona object

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `workspace_id` | `string` | Yes |  |
| `member_id` | `string` | Yes |  |