---
title: "BrandDecision"
description: "a tenant's decision on one value of the brand's design system: accepted, declined, or changed to the tenant's own; the brand's memory, read by the merge and by every builder"
section: concepts
address: /concepts/branddecision
contract: 0476e35e6e275db5
---

# BrandDecision

a tenant's decision on one value of the brand's design system: accepted, declined, or changed to the tenant's own; the brand's memory, read by the merge and by every builder

[figure: BrandDecision is a fact at brand scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | fact |
| scope | brand |
| key | the brand, the path and the time |
| store | postgres |
| family | market |



## Fields


| field | type | required | note |
|---|---|---|---|
| `brand` | `id` | yes |  |
| `path` | `text` | yes | the value's path in the system |
| `proposed` | `json` | no | the value proposed at the time |
| `decision` | `one of accepted \| declined \| changed` | yes |  |
| `value` | `json` | no | the tenant's own value when changed |
| `why` | `text` | no |  |
| `version` | `count` | yes | the version of the system the decision was made on |



## Routes that use it
- [`/v1/act/decide_brand_design`](/reference/act/decide_brand_design) returns it