# FeatureAuthorizationStatus

FeatureAuthorizationStatus

Pairs a feature with the channel's authorization status for it (token/scope
level). One entry per authorization-gated feature the channel exposes.

**Status:** ⚠️ Experimental

**Fields:**
- `feature`: `Feature!` - The feature this status describes — a capability a channel can expose, e.g.
posting, commenting, mentions, insights, reacting to engagements (see the
`Feature` enum).
- `reason`: `String` - Why the feature is in its current `status`, when a specific cause is known
(e.g. the connected platform user lacks rights on the account that owns
webhook subscriptions). Informative text for display/support — not a stable
machine key, so clients must not parse or switch on it. Null when the
status needs no explanation (`ok`) or no specific cause was identified.
- `status`: `AuthorizationStatus!` - Whether the channel is currently authorized to use `feature`: `ok` (usable),
`needsRefresh` (token refresh required), `notEnoughData` (missing scopes /
webhook metadata), `needsUpgrade` (client below the minimum version —
applies only to the mobile apps), or `notEnoughRights` (the connected
platform user's role is insufficient — reconnecting cannot fix it). See the
`AuthorizationStatus` enum.