HYPERFLEET-1467 - feat: Add the read-only tenancy map to the Resource spec

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.27] - 2026-08-11
+
+### Added
+
+- `tenancy` map (string to string) to the `Resource` response model, server-populated and read-only (HYPERFLEET-1467)
+
 ## [1.0.26] - 2026-07-09
 
 ### Added
@@ -240,7 +246,8 @@ First official stable release of the HyperFleet API specification.
 - Interactive API documentation
 
 <!-- Links -->
-[Unreleased]: https://github.com/openshift-hyperfleet/hyperfleet-api-spec/compare/v1.0.26...HEAD
+[Unreleased]: https://github.com/openshift-hyperfleet/hyperfleet-api-spec/compare/v1.0.27...HEAD
+[1.0.27]: https://github.com/openshift-hyperfleet/hyperfleet-api-spec/compare/v1.0.26...v1.0.27
 [1.0.26]: https://github.com/openshift-hyperfleet/hyperfleet-api-spec/compare/v1.0.25...v1.0.26
 [1.0.25]: https://github.com/openshift-hyperfleet/hyperfleet-api-spec/compare/v1.0.24...v1.0.25
 [1.0.23]: https://github.com/openshift-hyperfleet/hyperfleet-api-spec/compare/v1.0.22...v1.0.23

main.tsp

@@ -30,7 +30,7 @@ using OpenAPI;
  */
 @service(#{ title: "HyperFleet API" })
 @info(#{
-  version: "1.0.26",
+  version: "1.0.27",
   contact: #{
     name: "HyperFleet Team",
     url: "https://github.com/openshift-hyperfleet",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperfleet",
-  "version": "1.0.26",
+  "version": "1.0.27",
   "type": "module",
   "exports": {
     "./*": "./*"

schemas/core/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: HyperFleet API
-  version: 1.0.26
+  version: 1.0.27
   contact:
     name: HyperFleet Team
     url: https://github.com/openshift-hyperfleet
@@ -2446,6 +2446,12 @@ components:
             items:
               $ref: '#/components/schemas/ObjectReference'
           description: Non-ownership associations to other resources, keyed by reference type
+        tenancy:
+          type: object
+          additionalProperties:
+            type: string
+          description: Tenancy dimensions carried by the resource. Server-populated and read-only; not accepted on create or patch.
+          readOnly: true
         created_time:
           type: string
           format: date-time
@@ -2476,6 +2482,9 @@ components:
           environment: production
           team: platform
         spec: {}
+        tenancy:
+          organization_id: org-123
+          account_id: acct-456
         generation: 1
         status:
           conditions: []

shared/models/resource/example_resource.tsp

@@ -8,6 +8,7 @@ const exampleResource: Resource = #{
   name: "my-resource-1",
   labels: #{ environment: "production", team: "platform" },
   spec: #{},
+  tenancy: #{ organization_id: "org-123", account_id: "acct-456" },
   generation: 1,
   status: #{
     conditions: #[],

shared/models/resource/model.tsp

@@ -49,6 +49,10 @@ model Resource {
   /** Non-ownership associations to other resources, keyed by reference type */
   references?: Record<ObjectReference[]>;
 
+  /** Tenancy dimensions carried by the resource. Server-populated and read-only; not accepted on create or patch. */
+  @visibility(Lifecycle.Read)
+  tenancy?: Record<string>;
+
   ...APIMetadata;
 }