Skip to main content
Version: v4 (next)

Adjust a Permission

Adjust a permission's effective duration. This is useful when you need to extend or shorten the validity period of an existing permission without going through a full renewal process.

This is a delegable message — it requires an authority (group account) and can be executed by an authorized operator.

Prerequisites
  1. Group account (authority) — You need a Cosmos SDK group account that controls the permission: the permission's own authority (for ECOSYSTEM/self-created perms) or the validator's authority (for VP-managed perms).
  2. Operator authorization — Your operator account must be granted authorization for MsgAdjustPermission by the authority. See Grant Operator Authorization.
  3. Existing permission — The permission must exist and be in an active, adjustable state.

Message Parameters​

NameDescriptionMandatory
idNumeric ID of the permission to adjust.yes
effective-untilNew expiration timestamp (RFC 3339 format). Must be in the future.yes
--authorityGroup account (authority) on whose behalf this message is executed.yes

Post the Message​

Usage​

veranad tx perm adjust-perm <id> <effective-until> \
  --authority <group-account> \
  --from <operator-account> --chain-id <chain-id> --keyring-backend test --fees <amount> --gas auto --node $NODE_RPC

Example​

PERM_ID=10
veranad tx perm adjust-perm $PERM_ID 2027-12-31T23:59:59Z \
  --authority $AUTHORITY_ACC \
  --from $OPERATOR_ACC --chain-id $CHAIN_ID --keyring-backend test --fees 600000uvna --node $NODE_RPC

Verify the updated permission:

veranad q perm get-perm $PERM_ID --node $NODE_RPC --output json

Check that effective_until reflects the new timestamp.

See also​