GRgrove
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

Request

  • Base URL
    https://api.grove.city (the document declares no server; this is the origin it was published from)
  • URL
    https://api.grove.city/v1/account
  • Auth
    none declared

Headers

authorizationstring nullable

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

Changes

No recorded changes to this operation across all 1 revision of this API.