Skip to content

Person methods: update, delete

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

Reference for Person, one group of Person methods.

Person.update

Changes the given properties of a Person. Verb page.

TypeScript
interface PersonVerbs {
  update(input: PersonUpdateInput, options?: SB.CallOptions): SB.Call<Person>
}

Emits Person.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Person.
namestringThe legal or personal name.
verifiedbooleanTrue once the identity is verified.

Returns

OutputTypeRequiredDescription
personPersonrequiredThe Person.

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 person = await $.Person.update({ id: 'person_sLqbXbW683', verified: true })

Person.delete

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

TypeScript
interface PersonVerbs {
  delete(input: PersonDeleteInput, options?: SB.CallOptions): SB.Call<Person>
}

Emits Person.deleted.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Person.

Returns

OutputTypeRequiredDescription
personPersonrequiredThe Person.

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 person = await $.Person.delete({ id: 'person_sLqbXbW683' })