Skip to content

Handle commands: update

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

Reference for Handle, one group of Handle commands.

Handle.update

Changes the given properties of a Handle. Verb page.

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

Emits Handle.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Handle.
venuestringThe venue it lives on, by id.
namestringThe name as the platform shows it, such as @example.
sharedbooleanTrue for a Studio account shared across sibling Startups; every Post names the Startup it speaks for.
agentbooleanTrue when an Agent runs it; its bio says so.
integrationIntegrationThe Integration credential it publishes through.

Returns

OutputTypeRequiredDescription
handleHandlerequiredThe Handle.

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 Handle.update --json '{"id":"handle_FcnNwYQujc","name":"Leaseline"}'