v1
latestOpenAPI 3.1.02026-07-13143194365.4 KBaccount
Claim a handle for your account
Claim a Twitter-style handle for your account.
Handle requirements:
- 3-15 characters
- Lowercase letters, numbers, and underscores only
- Cannot start or end with underscore
- Cannot have consecutive underscores
- Certain handles are reserved (admin, grove, support, etc.)
Authentication: Authorization: Bearer <CLIENT_JWT>
Notes:
- Each account can only have one handle at a time
- Handles must be globally unique
- To change your handle, release and re-claim via this endpoint. For atomic renames (no release-then-claim race window), use the admin-only POST /admin/maintenance/change-handle endpoint.
post/v1/account/handle
Headers
authorizationstring nullable
Bearer JWT issued by Grove that identifies the account.
Bearer JWT issued by Grove that identifies the account.
Request body
Example request
{
"handle": "alice"
}Response
Successful Response