Skip to content

Watch commands: update, delete

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

Reference for Watch, one group of Watch commands.

Watch.update

Changes the given properties of a Watch. Verb page.

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

Emits Watch.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Watch.
selectorstringThe Event selector, such as Order.placed.
urlurlWhere deliveries go.
payloadstringOne of full, or thin: the record as the Action left it, or only its versioned address. The default is full.

Returns

OutputTypeRequiredDescription
watchWatchrequiredThe Watch.

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 Watch.update --json '{"id":"watch_9o4vCuR17L","url":"https://leaseline.app"}'

Watch.delete

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

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

Emits Watch.deleted.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Watch.

Returns

OutputTypeRequiredDescription
watchWatchrequiredThe Watch.

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 Watch.delete --json '{"id":"watch_9o4vCuR17L"}'