Skip to content

Setting commands: update, delete

The Setting Verbs update, delete as CLI commands, with inputs, result, refusals and an example.

Reference for Setting, one group of Setting commands.

Setting.update

Changes the given properties of a Setting. Verb page.

Text
npx startup-builder do Setting.update --json '<input>' [--try | --send | --do]

Emits Setting.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Setting.
keystringThe name of the choice.
valuejsonThe chosen value.
lockedbooleanTrue when no holder below may override it.

Returns

OutputTypeRequiredDescription
settingSettingrequiredThe Setting.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
npx startup-builder do Setting.update --json '{"id":"setting_mfZPXxFQYD","value":{}}'

Setting.delete

Deletes a Setting: a soft delete that keeps its history, undone by Thing.restore. Verb page.

Text
npx startup-builder do Setting.delete --json '<input>' [--try | --send | --do]

Emits Setting.deleted.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Setting.

Returns

OutputTypeRequiredDescription
settingSettingrequiredThe Setting.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
npx startup-builder do Setting.delete --json '{"id":"setting_mfZPXxFQYD"}'