Skip to content

Verb methods: retire

The Verb Verbs retire as typed SDK methods, with inputs, result, refusals and an example.

Reference for Verb, one group of Verb methods.

Verb.retire

Retire removes a published Verb from new Versions; callers pinned to earlier Versions keep calling it. Verb page.

TypeScript
interface VerbVerbs {
  retire(input: VerbRetireInput, options?: SB.CallOptions): SB.Call<VerbRetireOutput>
}

Emits Verb.retired.

Inputs

InputTypeRequiredDescription
verbVerbrequiredThe Verb to retire.

Returns

OutputTypeRequiredDescription
versionVersionrequiredThe new Version, without the Verb.
verbVerbrequiredThe Verb, now retired from new Versions.

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

TypeScript
import { $ } from 'startup-builder'

const { version, verb } = await $.Verb.retire({ verb: 'verb_hlkWBvrAyZ' })