Skip to main content
PATCH
Update customer fees
Send any combination of feeRecipientAddress, managementFeeBps and performanceFeeBps. Omitted fields stay unchanged. Your recipient receives both management and performance fee shares; Ground’s allocation stays unchanged. Before signing is enabled, fee changes execute automatically. Once enabled, approve the returned activityId with your configured signer quorum through the portal or approval API. Wait for feeUpdate.status: confirmed before treating the change as effective. See configure fees.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

gVaultId
string
required

Organization gVault UUID returned by discovery. Existing approved direct integrations retain their source slug.

Pattern: ^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|ground-ustb-vault|ground-tempo-prime-vault)$
Example:

"8f4c52d7-62ab-4db9-a964-92f481f6b851"

Body

application/json

Update your management rate, performance rate or fee recipient. Updates execute automatically before customer signing is enabled. After enablement, the configured customer quorum approves through the existing Turnkey endpoints. Ground's fee is already configured; changes initiated by Ground follow the same customer signing requirements. Omitted fields retain their current values. Only one update may be active per gVault.

feeRecipientAddress
string

Recipient of your management and performance fee shares. Set a recipient distinct from Ground before enabling either customer fee. Changing it preserves your rates.

Required string length: 42
Pattern: ^0x(?!0{40}$)[0-9a-fA-F]{40}$
Example:

"0x3bf25a73a1f1033c2d50ac65f3c9d6a44123db81"

managementFeeBps
integer

Your annual management rate. Zero removes only your allocation. Your rate plus Ground's rate must fit the deployed ceiling and remain below 10000 bps.

Required range: 0 <= x <= 9999
performanceFeeBps
integer

Performance rate within the deployed ceiling.

Required range: 0 <= x <= 9999

Response

Already confirmed.

status
enum<string>
required

awaiting_approval means your approval is required.

Available options:
preparing,
queued,
submitting,
awaiting_approval,
submitted,
confirmed,
failed
activityId
string

Signing activity for this update. Once signing is enabled, your configured signers approve this activity through the portal or approval API.

transactionHash
string

EVM transaction hash.

Required string length: 66
Pattern: ^0x[0-9a-fA-F]{64}$
Example:

"0xabababababababababababababababababababababababababababababababab"