Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
account

Update account metadata

Merge user-provided metadata into the account and return the updated snapshot.

Authentication: Authorization: Bearer <CLIENT_JWT>

Request body:

  • metadata (object, optional): Arbitrary key/value pairs to merge. Existing keys are overwritten by new ones.

Notes / TODOs:

  • Define allowed/reserved metadata keys and size limits before widening usage.
  • Add email account support and determine how to integrate with other OAuth flows.
post/v1/account

Headers

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Bearer JWT issued by Grove that identifies the account.

Request body

metadataobject nullable

Response

Successful Response

account_idstring required
tipping_addressstring required
earning_addressstring nullable
eoa_owner_addressstring nullable
smart_account_addressstring nullable

ERC-4337 Smart Account address (the earning wallet)

external_linked_walletsstring[]

External linked wallet addresses (profile references, non-earning)

networkstring required
metadataobject nullable
handlestring nullable
referral_codestring required
referred_by_account_idstring nullable
referral_countinteger
onchain_addressstring required
embedded_wallet_addressstring nullable required
client_addressstring nullable required
earnings_addressstring nullable required