# PolicyDecision

> The PolicyDecision object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `decision` * | `allow`, `deny`, `approval_required` |  |
| `reasons` | array of [PolicyReason](/docs/api/objects/policy-reason/) |  |
| `approver_roles` | array of [Role](/docs/api/objects/role/) |  |
| `tier` | integer | AI ops tier for platform runbook tools (0 read-only, 3 human approval). |

\* always present

## Example

```json
{
  "decision": "allow",
  "reasons": [
    {
      "code": "environment_protected",
      "message": "production requires approval for changes made by agents",
      "policy": "guv.environment.protection"
    }
  ],
  "approver_roles": [
    "owner"
  ],
  "tier": 0
}
```
