v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
account

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

handlestring required

Handle to claim (3-15 chars, lowercase alphanumeric + underscore)

Example request

{
  "handle": "alice"
}

Response

Successful Response

handlestring required

The claimed handle (normalized)

account_idstring required

Account ID that owns the handle