coder · jaaydenh · Aug 24, 2026 · Aug 24, 2026 · Aug 24, 2026 · Aug 24, 2026
diff --git a/coderd/apidoc/docs.go b/coderd/apidoc/docs.go
diff --git a/coderd/apidoc/swagger.json b/coderd/apidoc/swagger.json
diff --git a/codersdk/deployment.go b/codersdk/deployment.go
@@ -396,12 +396,15 @@ type Feature struct {
 	HardLimit *int64 `json:"hard_limit,omitempty"`
 	// Actual is the usage measured against Limit, when known: a
 	// point-in-time count for most features, or usage accumulated over
-	// UsagePeriod for features that set one. Its unit matches Limit's;
+	// UsagePeriod for features that set one. FeatureAgentRuntimeHours
+	// without a licensed usage period instead reports all retained usage
+	// since tracking began without a UsagePeriod. Its unit matches Limit's;
 	// FeatureAgentRuntimeHours reports whole hours floored from the
 	// recorded milliseconds, with the precise value available in
 	// ActualMs. FeatureAgentRuntimeHours usage can trail by roughly one
 	// hour because the current hour is not emitted, plus the entitlement
-	// refresh interval.
+	// refresh interval, and can undercount after outages beyond the usage
+	// event backfill window.
 	Actual *int64 `json:"actual,omitempty"`
 	// ActualMs is the precise usage backing Actual, in milliseconds, for
 	// features measured in time. It has the same freshness as Actual.

diff --git a/codersdk/deployment_test.go b/codersdk/deployment_test.go
@@ -1072,8 +1072,8 @@ func TestEntitlementsCapabilities(t *testing.T) {
 			codersdk.FeatureAuditLog: {
 				Entitlement: codersdk.EntitlementEntitled,
 				Enabled:     true,
-				Limit:       ptr.Ref(int64(10)),
-				Actual:      ptr.Ref(int64(5)),
+				Limit:       new(int64(10)),
+				Actual:      new(int64(5)),
 			},
 			codersdk.FeatureSCIM: {
 				Entitlement: codersdk.EntitlementGracePeriod,
@@ -1082,8 +1082,8 @@ func TestEntitlementsCapabilities(t *testing.T) {
 			codersdk.FeatureUserLimit: {
 				Entitlement: codersdk.EntitlementEntitled,
 				Enabled:     true,
-				Limit:       ptr.Ref(int64(1)),
-				Actual:      ptr.Ref(int64(2)),
+				Limit:       new(int64(1)),
+				Actual:      new(int64(2)),
 			},
 			codersdk.FeatureBrowserOnly: {
 				Entitlement: codersdk.EntitlementEntitled,
@@ -1092,9 +1092,9 @@ func TestEntitlementsCapabilities(t *testing.T) {
 			codersdk.FeatureAppearance: {
 				Entitlement: codersdk.EntitlementNotEntitled,
 				Enabled:     true,
-				SoftLimit:   ptr.Ref(int64(3)),
-				HardLimit:   ptr.Ref(int64(4)),
-				ActualMs:    ptr.Ref(int64(5)),
+				SoftLimit:   new(int64(3)),
+				HardLimit:   new(int64(4)),
+				ActualMs:    new(int64(5)),
 				UsagePeriod: &codersdk.UsagePeriod{IssuedAt: time.Now()},
 			},
 		},

diff --git a/docs/reference/api/schemas.md b/docs/reference/api/schemas.md