v1

latestOpenAPI 3.0.02026-07-246171,3332.1 MB
v2

post/update-account-settings

Request body

addressstring

Address

allowed-client-typestring[]

A default list of client types that are allowed to authenticate [cli,ui,gateway-admin,sdk,mobile,extension].

allowed-email-domainsstring[]

Limits email sharing to the specified domains. Relevant only when item sharing is enabled. By default, all domains are allowed.

bound-ipsstring[]

A default list of comma-separated CIDR block that are allowed to authenticate.

citystring

City

company-namestring

Company name

countrystring

Country

default-certificate-expiration-notification-daysstring[]

How many days before the expiration of the certificate would you like to be notified. To specify multiple events, use argument multiple times: --default-certificate-expiration-notification-days 1 --default-certificate-expiration-notification-days 5

default-key-namestring

Set the account default key based on the DFC key name. Use "set-original-akeyless-default-key" to revert to using the original default key of the account.

default-share-link-ttl-minutesstring

Set the default ttl in minutes for sharing item number between 60 and 43200

default-versioningstring

If set to true, new versions is enabled by default

dp-enable-classic-key-protectionstring

Set to update protection with classic keys state [true/false]

dynamic-secret-max-ttlinteger

Set the maximum ttl for dynamic secrets

dynamic-secret-max-ttl-enablestring

Set a maximum ttl for dynamic secrets [true/false]

enable-ai-insightsstring

Enable AI insights [true/false]

enable-default-certificate-expiration-eventstring

How many days before the expiration of the certificate would you like to be notified. [true/false]

enable-item-sharingstring

Enable sharing items [true/false]

enable-password-expirationstring

Enable password expiration policy [true/false]

force-new-versionsstring

If set to true, new version will be created on update

gw-bound-ipsstring[]

A default list of comma-separated CIDR block that acts as a trusted Gateway entity.

hide-personal-folderstring

Hide personal folder, if set - users will not be able to use personal folder [true/false]

hide-static-passwordstring

Hide static secret's password type [true/false]

invalid-charactersstring

Characters that cannot be used for items/targets/roles/auths/event_forwarder names. Empty string will enforce nothing.

item-locking-enabledstring

Enable item locking feature [true/false]

item-typestring

VersionSettingsObjectType defines object types for account version settings

items-deletion-protectionstring

Set or unset the default behaviour of items deletion protection [true/false]

jsonboolean

Set output format to JSON

jwt-ttl-defaultinteger

Default ttl

jwt-ttl-maxinteger

Maximum ttl

jwt-ttl-mininteger

Minimum ttl

lock-allowed-client-typestring

Lock allowed-client-type setting in the account [true/false].

lock-bound-ipsstring

Lock bound-ips setting globally in the account.

lock-default-keystring

Lock the account's default protection key, if set - users will not be able to use a different protection key, relevant only if default-key-name is configured [true/false]

lock-gw-bound-ipsstring

Lock gw-bound-ips setting in the account.

lock-max-ttlinteger

Set the maximum TTL for item/target locks in minutes

max-rotation-intervalinteger

Set the maximum rotation interval for rotated secrets auto rotation settings

max-rotation-interval-enablestring

Set a maximum rotation interval for rotated secrets auto rotation settings [true/false]

max-versionsstring

Max versions

password-expiration-daysstring

Specifies the number of days that a password is valid before it must be changed. A default value of 90 days is used.

password-expiration-notification-daysstring

Specifies the number of days before a user receives notification that their password will expire. A default value of 14 days is used.

password-lengthinteger

Password length between 5 - to 50 characters

phonestring

Phone number

postal-codestring

Postal code

tokenstring

Authentication token (see /auth and /configure)

uid-tokenstring

The universal identity token, Required only for universal_identity authentication

usage-event-enablestring

Enable event for objects that have not been used or changed [true/false]

usage-event-intervalinteger

Interval by days for unused objects. Default and minimum interval is 90 days

usage-event-object-typestring

Usage event is supported for auth method or secrets-and-keys [auth/item]

use-capital-lettersstring

Password must contain capital letters [true/false]

use-lower-lettersstring

Password must contain lower case letters [true/false]

use-numbersstring

Password must contain numbers [true/false]

use-special-charactersstring

Password must contain special characters [true/false]

Response

updateAccountSettingsResponse wraps response body.

updatedboolean