Skip to content

Prospect methods: update, delete

The Prospect Verbs update, delete as typed SDK methods, with inputs, result, refusals and an example.

Reference for Prospect, one group of Prospect methods.

Prospect.update

Changes the given properties of a Prospect. Verb page.

TypeScript
interface ProspectVerbs {
  update(input: ProspectUpdateInput, options?: SB.CallOptions): SB.Call<Prospect>
}

Emits Prospect.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Prospect.
foundInstringWhere the Startup found them.
basisstringThe basis on record for contacting them.

Returns

OutputTypeRequiredDescription
prospectProspectrequiredThe Prospect.

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 prospect = await $.Prospect.update({ id: 'prospect_S8bqJCxC9R', foundIn: 'Example found in' })

Prospect.delete

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

TypeScript
interface ProspectVerbs {
  delete(input: ProspectDeleteInput, options?: SB.CallOptions): SB.Call<Prospect>
}

Emits Prospect.deleted.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Prospect.

Returns

OutputTypeRequiredDescription
prospectProspectrequiredThe Prospect.

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 prospect = await $.Prospect.delete({ id: 'prospect_S8bqJCxC9R' })