> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parmanasystems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# parmana.models.authority_grant

Parmana authority grants (RFC-0023 phase 3): which API key may have which
capability decided, within which limits, until when, made through maker
checker. They matter for a policy with requireAuthorityGrant; GET
/policies/in-effect says so with authority\_grant\_required.

Hand-maintained: the response bodies of the /authority-grants routes
(packages/api/src/routes/authority-grants.ts).

## AuthorityGrant Objects

```python theme={null}
@dataclass(frozen=True)
class AuthorityGrant()
```

A grant, active or revoked.

#### grant\_id

The change\_id of the approved grant change that created it.

#### caller\_id

The callerId of the API key the grant is for.

#### valid\_until

After this, requests are refused as AUTHORITY\_EXPIRED.

#### status

"active" or "revoked". At most one active grant per caller and
capability.

#### limits

By Intent path ("target", "parameters.\<name>"): "min", "max" and
"oneOf", as sent.

## AuthorityGrantChange Objects

```python theme={null}
@dataclass(frozen=True)
class AuthorityGrantChange()
```

A proposal to grant or revoke authority, and its resolution. Sign the
step up authorization for approve or reject with `change_id` as
`pending_policy_change_id`.

#### action

"grant" or "revoke".


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.