---
title: "Update My Handle"
method: PATCH
path: "/v2/profiles/me/handle"
tags: ["v2 - Profiles"]
---

# Update My Handle

`PATCH /v2/profiles/me/handle`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/profiles/me/handle`
- Auth: HTTP bearer

Set or change the authenticated user's @handle.

Validation rules (src/utils/handle.py):
- 3 to 30 chars
- Lowercase letters, numbers, underscores only
- Must start with a letter
- Cannot be on the reserved list

Uniqueness: case-insensitive. Returns 409 if another profile holds the
handle (the current user holding it is a no-op success).

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Request body

- UpdateMyHandleRequest: PATCH /v2/profiles/me/handle — claim or change @handle.
  - `handle` string, required: 3 to 30 chars, lowercase letters, numbers, or underscores, starting with a letter.

## Response `200`

Successful Response

- ProfileSummary: Lightweight profile data for display purposes. PRIVACY (founder's rule, 2026-09-25): for anyone but the caller themself (`is_you`) and a platform admin, this is the PUBLIC profile only: `profile_id` and `email` are null, `display_name` is a public name or their role, else "Member" (2026-10-08). Your own record carries both.
  - `profile_id` string, nullable
  - `is_you` boolean
  - `display_name` string, nullable
  - `email` string, nullable
  - `avatar_url` string, nullable
  - `bio` string, nullable
  - `email_confirmation` string, nullable
  - `handle` string, nullable
  - `wallet_rails` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)