Skip to content

Purpose

A Purpose is a named reason personal data is processed, with a lawful basis per jurisdiction.

Properties

PropertyTypeRequiredDescription
namestringrequiredThe reason, such as marketing email or call recording.

Object

JSON
{
  "$id": "https://api.sb/kilnbakery.com/purposes/purpose_1",
  "$type": "Purpose",
  "name": "Kiln Bakery"
}

Relationships

  • A Purpose has many Consents: the Purpose the Consent permits processing for, and nothing beyond it. consents, inverse covers.

Verbs

  1. createCreates a Purpose.
    POST /{namespace}/purposesdoPurpose.created
  2. getReturns one Purpose by id.
    GET /{namespace}/purposes/{id}readNo Event
  3. listReturns Purposes, newest first, one page at a time.
    GET /{namespace}/purposesreadNo Event
  4. updateChanges the given properties of a Purpose.
    PATCH /{namespace}/purposes/{id}doPurpose.updated
  5. deleteDeletes a Purpose; its history is kept.
    DELETE /{namespace}/purposes/{id}doPurpose.deleted

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Purpose.createYesYesYesNo
Purpose.getYesYesYesYes
Purpose.listYesYesYesYes
Purpose.updateYesYesYesNo
Purpose.deleteYesYesYesNo

Call it

Text
Add a purpose to PetPantry.

Example

"Send product updates" is a Purpose with consent as its lawful basis. "Bill the Customer" is a Purpose with contract as its basis.