Purpose
A Purpose is a named reason personal data is processed, with a lawful basis per jurisdiction.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
name | string | required | The reason, such as marketing email or call recording. |
Object
{
"$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, inversecovers.
Verbs
createCreates a Purpose.POST /{namespace}/purposesgetReturns one Purpose by id.GET /{namespace}/purposes/{id}listReturns Purposes, newest first, one page at a time.GET /{namespace}/purposesupdateChanges the given properties of a Purpose.PATCH /{namespace}/purposes/{id}deleteDeletes a Purpose; its history is kept.DELETE /{namespace}/purposes/{id}
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Purpose.create | Yes | Yes | Yes | No |
Purpose.get | Yes | Yes | Yes | Yes |
Purpose.list | Yes | Yes | Yes | Yes |
Purpose.update | Yes | Yes | Yes | No |
Purpose.delete | Yes | Yes | Yes | No |
Call it
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.