@meshery/schemas 1.3.55 → 1.3.57

package/dist/cloudApi.d.mts

@@ -366,7 +366,7 @@ type GetOrganizationSmtpConfigurationApiResponse = {
     fromDisplayName?: string;
     /** Address replies are directed to. It is also the address carried when a message falls back to the provider relay, which rewrites the from address to the provider's own so the message stays aligned for SPF and DMARC. */
     replyToAddress?: string;
-    /** Lifecycle and transport verdict, carrying the connection status vocabulary because the configuration IS a connection. `registered` means configured but never proven - the from domain is unverified, or no message has yet been delivered - and mail takes the provider relay. `connected` means the last delivery attempt succeeded and mail is routed through this server. `disconnected` means the most recent delivery attempt did not succeed, and `fallbackToProvider` governs what becomes of that message. It is a verdict on the last attempt alone: a SINGLE failure records it, there is no failure threshold, and the status does not by itself stop the server being dialled for the next message. Read it as "the last attempt failed", not as "this server has been taken out of rotation" - the circuit breaker that would do the latter is planned, not built, and is tracked in layer5io/meshery-cloud#6057. `ignored` means an administrator turned it off.
+    /** Lifecycle and transport verdict, carrying the connection status vocabulary because the configuration IS a connection. `registered` means configured but never proven - the from domain is unverified, or no message has yet been delivered - and mail takes the provider relay. `connected` means the last delivery attempt succeeded and mail is routed through this server. `disconnected` means the most recent delivery attempt did not succeed, and `fallbackToProvider` governs what becomes of that message. It is a verdict on the last attempt alone: a SINGLE failure records it, there is no failure threshold, and the status does not by itself stop the server being dialled for the next message. Read it as "the last attempt failed", not as "this server has been taken out of rotation" - the circuit breaker that would do the latter is planned, not built, and is tracked in meshery-cloud#6057. `ignored` means an administrator turned it off.
       
       The writers are disjoint on purpose: only an administrator writes `ignored`, and only a delivery outcome writes `connected` or `disconnected`. That is what keeps a deliberate opt-out distinguishable from a failing relay. It also makes "enabled while the from domain is unverified" unrepresentable rather than merely forbidden, which is why this property replaces the separate `enabled` and `verificationState` pair it supersedes. */
     status: "registered" | "connected" | "disconnected" | "ignored";
@@ -384,7 +384,7 @@ type GetOrganizationSmtpConfigurationApiResponse = {
     lastFailureAt?: string | null;
     /** Classification of the last failure. Always a classification, never the remote server's own message: the set is closed on purpose, because reporting a remote server's text back to a caller would turn a refusal into an oracle for what the network can reach. */
     lastFailureReason?: "blocked_target" | "connect_refused" | "connect_timeout" | "tls_failed" | "starttls_unsupported" | "auth_rejected" | "relay_rejected_sender" | "relay_rejected_recipient" | "delivery_failed" | "credential_unreadable";
-    /** Count of delivery attempts that have failed since the last success, reset to zero by a success. It is a RECORD and nothing more: no threshold reads it, and reaching any particular value does not itself stop a persistently unreachable server being dialled. A consumer must not treat a non-zero count as protection already in place. The circuit breaker that would consume this count - and which needs a threshold, a reset policy, and a decision about its interaction with `fallbackToProvider`, where an open circuit with fallback off drops account-verification and password-recovery mail - is planned under layer5io/meshery-cloud#6057. */
+    /** Count of delivery attempts that have failed since the last success, reset to zero by a success. It is a RECORD and nothing more: no threshold reads it, and reaching any particular value does not itself stop a persistently unreachable server being dialled. A consumer must not treat a non-zero count as protection already in place. The circuit breaker that would consume this count - and which needs a threshold, a reset policy, and a decision about its interaction with `fallbackToProvider`, where an open circuit with fallback off drops account-verification and password-recovery mail - is planned under meshery-cloud#6057. */
     consecutiveFailures: number;
     /** A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas. */
     createdBy?: string | null;
@@ -423,7 +423,7 @@ type CreateOrganizationSmtpConfigurationApiResponse = {
     fromDisplayName?: string;
     /** Address replies are directed to. It is also the address carried when a message falls back to the provider relay, which rewrites the from address to the provider's own so the message stays aligned for SPF and DMARC. */
     replyToAddress?: string;
-    /** Lifecycle and transport verdict, carrying the connection status vocabulary because the configuration IS a connection. `registered` means configured but never proven - the from domain is unverified, or no message has yet been delivered - and mail takes the provider relay. `connected` means the last delivery attempt succeeded and mail is routed through this server. `disconnected` means the most recent delivery attempt did not succeed, and `fallbackToProvider` governs what becomes of that message. It is a verdict on the last attempt alone: a SINGLE failure records it, there is no failure threshold, and the status does not by itself stop the server being dialled for the next message. Read it as "the last attempt failed", not as "this server has been taken out of rotation" - the circuit breaker that would do the latter is planned, not built, and is tracked in layer5io/meshery-cloud#6057. `ignored` means an administrator turned it off.
+    /** Lifecycle and transport verdict, carrying the connection status vocabulary because the configuration IS a connection. `registered` means configured but never proven - the from domain is unverified, or no message has yet been delivered - and mail takes the provider relay. `connected` means the last delivery attempt succeeded and mail is routed through this server. `disconnected` means the most recent delivery attempt did not succeed, and `fallbackToProvider` governs what becomes of that message. It is a verdict on the last attempt alone: a SINGLE failure records it, there is no failure threshold, and the status does not by itself stop the server being dialled for the next message. Read it as "the last attempt failed", not as "this server has been taken out of rotation" - the circuit breaker that would do the latter is planned, not built, and is tracked in meshery-cloud#6057. `ignored` means an administrator turned it off.
       
       The writers are disjoint on purpose: only an administrator writes `ignored`, and only a delivery outcome writes `connected` or `disconnected`. That is what keeps a deliberate opt-out distinguishable from a failing relay. It also makes "enabled while the from domain is unverified" unrepresentable rather than merely forbidden, which is why this property replaces the separate `enabled` and `verificationState` pair it supersedes. */
     status: "registered" | "connected" | "disconnected" | "ignored";
@@ -441,7 +441,7 @@ type CreateOrganizationSmtpConfigurationApiResponse = {
     lastFailureAt?: string | null;
     /** Classification of the last failure. Always a classification, never the remote server's own message: the set is closed on purpose, because reporting a remote server's text back to a caller would turn a refusal into an oracle for what the network can reach. */
     lastFailureReason?: "blocked_target" | "connect_refused" | "connect_timeout" | "tls_failed" | "starttls_unsupported" | "auth_rejected" | "relay_rejected_sender" | "relay_rejected_recipient" | "delivery_failed" | "credential_unreadable";
-    /** Count of delivery attempts that have failed since the last success, reset to zero by a success. It is a RECORD and nothing more: no threshold reads it, and reaching any particular value does not itself stop a persistently unreachable server being dialled. A consumer must not treat a non-zero count as protection already in place. The circuit breaker that would consume this count - and which needs a threshold, a reset policy, and a decision about its interaction with `fallbackToProvider`, where an open circuit with fallback off drops account-verification and password-recovery mail - is planned under layer5io/meshery-cloud#6057. */
+    /** Count of delivery attempts that have failed since the last success, reset to zero by a success. It is a RECORD and nothing more: no threshold reads it, and reaching any particular value does not itself stop a persistently unreachable server being dialled. A consumer must not treat a non-zero count as protection already in place. The circuit breaker that would consume this count - and which needs a threshold, a reset policy, and a decision about its interaction with `fallbackToProvider`, where an open circuit with fallback off drops account-verification and password-recovery mail - is planned under meshery-cloud#6057. */
     consecutiveFailures: number;
     /** A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas. */
     createdBy?: string | null;
@@ -505,7 +505,7 @@ type UpdateOrganizationSmtpConfigurationApiResponse = {
     fromDisplayName?: string;
     /** Address replies are directed to. It is also the address carried when a message falls back to the provider relay, which rewrites the from address to the provider's own so the message stays aligned for SPF and DMARC. */
     replyToAddress?: string;
-    /** Lifecycle and transport verdict, carrying the connection status vocabulary because the configuration IS a connection. `registered` means configured but never proven - the from domain is unverified, or no message has yet been delivered - and mail takes the provider relay. `connected` means the last delivery attempt succeeded and mail is routed through this server. `disconnected` means the most recent delivery attempt did not succeed, and `fallbackToProvider` governs what becomes of that message. It is a verdict on the last attempt alone: a SINGLE failure records it, there is no failure threshold, and the status does not by itself stop the server being dialled for the next message. Read it as "the last attempt failed", not as "this server has been taken out of rotation" - the circuit breaker that would do the latter is planned, not built, and is tracked in layer5io/meshery-cloud#6057. `ignored` means an administrator turned it off.
+    /** Lifecycle and transport verdict, carrying the connection status vocabulary because the configuration IS a connection. `registered` means configured but never proven - the from domain is unverified, or no message has yet been delivered - and mail takes the provider relay. `connected` means the last delivery attempt succeeded and mail is routed through this server. `disconnected` means the most recent delivery attempt did not succeed, and `fallbackToProvider` governs what becomes of that message. It is a verdict on the last attempt alone: a SINGLE failure records it, there is no failure threshold, and the status does not by itself stop the server being dialled for the next message. Read it as "the last attempt failed", not as "this server has been taken out of rotation" - the circuit breaker that would do the latter is planned, not built, and is tracked in meshery-cloud#6057. `ignored` means an administrator turned it off.
       
       The writers are disjoint on purpose: only an administrator writes `ignored`, and only a delivery outcome writes `connected` or `disconnected`. That is what keeps a deliberate opt-out distinguishable from a failing relay. It also makes "enabled while the from domain is unverified" unrepresentable rather than merely forbidden, which is why this property replaces the separate `enabled` and `verificationState` pair it supersedes. */
     status: "registered" | "connected" | "disconnected" | "ignored";
@@ -523,7 +523,7 @@ type UpdateOrganizationSmtpConfigurationApiResponse = {
     lastFailureAt?: string | null;
     /** Classification of the last failure. Always a classification, never the remote server's own message: the set is closed on purpose, because reporting a remote server's text back to a caller would turn a refusal into an oracle for what the network can reach. */
     lastFailureReason?: "blocked_target" | "connect_refused" | "connect_timeout" | "tls_failed" | "starttls_unsupported" | "auth_rejected" | "relay_rejected_sender" | "relay_rejected_recipient" | "delivery_failed" | "credential_unreadable";
-    /** Count of delivery attempts that have failed since the last success, reset to zero by a success. It is a RECORD and nothing more: no threshold reads it, and reaching any particular value does not itself stop a persistently unreachable server being dialled. A consumer must not treat a non-zero count as protection already in place. The circuit breaker that would consume this count - and which needs a threshold, a reset policy, and a decision about its interaction with `fallbackToProvider`, where an open circuit with fallback off drops account-verification and password-recovery mail - is planned under layer5io/meshery-cloud#6057. */
+    /** Count of delivery attempts that have failed since the last success, reset to zero by a success. It is a RECORD and nothing more: no threshold reads it, and reaching any particular value does not itself stop a persistently unreachable server being dialled. A consumer must not treat a non-zero count as protection already in place. The circuit breaker that would consume this count - and which needs a threshold, a reset policy, and a decision about its interaction with `fallbackToProvider`, where an open circuit with fallback off drops account-verification and password-recovery mail - is planned under meshery-cloud#6057. */
     consecutiveFailures: number;
     /** A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas. */
     createdBy?: string | null;
@@ -583,7 +583,7 @@ type RotateOrganizationSmtpCredentialApiResponse =
     fromDisplayName?: string;
     /** Address replies are directed to. It is also the address carried when a message falls back to the provider relay, which rewrites the from address to the provider's own so the message stays aligned for SPF and DMARC. */
     replyToAddress?: string;
-    /** Lifecycle and transport verdict, carrying the connection status vocabulary because the configuration IS a connection. `registered` means configured but never proven - the from domain is unverified, or no message has yet been delivered - and mail takes the provider relay. `connected` means the last delivery attempt succeeded and mail is routed through this server. `disconnected` means the most recent delivery attempt did not succeed, and `fallbackToProvider` governs what becomes of that message. It is a verdict on the last attempt alone: a SINGLE failure records it, there is no failure threshold, and the status does not by itself stop the server being dialled for the next message. Read it as "the last attempt failed", not as "this server has been taken out of rotation" - the circuit breaker that would do the latter is planned, not built, and is tracked in layer5io/meshery-cloud#6057. `ignored` means an administrator turned it off.
+    /** Lifecycle and transport verdict, carrying the connection status vocabulary because the configuration IS a connection. `registered` means configured but never proven - the from domain is unverified, or no message has yet been delivered - and mail takes the provider relay. `connected` means the last delivery attempt succeeded and mail is routed through this server. `disconnected` means the most recent delivery attempt did not succeed, and `fallbackToProvider` governs what becomes of that message. It is a verdict on the last attempt alone: a SINGLE failure records it, there is no failure threshold, and the status does not by itself stop the server being dialled for the next message. Read it as "the last attempt failed", not as "this server has been taken out of rotation" - the circuit breaker that would do the latter is planned, not built, and is tracked in meshery-cloud#6057. `ignored` means an administrator turned it off.
     
     The writers are disjoint on purpose: only an administrator writes `ignored`, and only a delivery outcome writes `connected` or `disconnected`. That is what keeps a deliberate opt-out distinguishable from a failing relay. It also makes "enabled while the from domain is unverified" unrepresentable rather than merely forbidden, which is why this property replaces the separate `enabled` and `verificationState` pair it supersedes. */
     status: "registered" | "connected" | "disconnected" | "ignored";
@@ -601,7 +601,7 @@ type RotateOrganizationSmtpCredentialApiResponse =
     lastFailureAt?: string | null;
     /** Classification of the last failure. Always a classification, never the remote server's own message: the set is closed on purpose, because reporting a remote server's text back to a caller would turn a refusal into an oracle for what the network can reach. */
     lastFailureReason?: "blocked_target" | "connect_refused" | "connect_timeout" | "tls_failed" | "starttls_unsupported" | "auth_rejected" | "relay_rejected_sender" | "relay_rejected_recipient" | "delivery_failed" | "credential_unreadable";
-    /** Count of delivery attempts that have failed since the last success, reset to zero by a success. It is a RECORD and nothing more: no threshold reads it, and reaching any particular value does not itself stop a persistently unreachable server being dialled. A consumer must not treat a non-zero count as protection already in place. The circuit breaker that would consume this count - and which needs a threshold, a reset policy, and a decision about its interaction with `fallbackToProvider`, where an open circuit with fallback off drops account-verification and password-recovery mail - is planned under layer5io/meshery-cloud#6057. */
+    /** Count of delivery attempts that have failed since the last success, reset to zero by a success. It is a RECORD and nothing more: no threshold reads it, and reaching any particular value does not itself stop a persistently unreachable server being dialled. A consumer must not treat a non-zero count as protection already in place. The circuit breaker that would consume this count - and which needs a threshold, a reset policy, and a decision about its interaction with `fallbackToProvider`, where an open circuit with fallback off drops account-verification and password-recovery mail - is planned under meshery-cloud#6057. */
     consecutiveFailures: number;
     /** A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas. */
     createdBy?: string | null;
@@ -644,7 +644,7 @@ type SetOrganizationSmtpEnablementApiResponse = {
     fromDisplayName?: string;
     /** Address replies are directed to. It is also the address carried when a message falls back to the provider relay, which rewrites the from address to the provider's own so the message stays aligned for SPF and DMARC. */
     replyToAddress?: string;
-    /** Lifecycle and transport verdict, carrying the connection status vocabulary because the configuration IS a connection. `registered` means configured but never proven - the from domain is unverified, or no message has yet been delivered - and mail takes the provider relay. `connected` means the last delivery attempt succeeded and mail is routed through this server. `disconnected` means the most recent delivery attempt did not succeed, and `fallbackToProvider` governs what becomes of that message. It is a verdict on the last attempt alone: a SINGLE failure records it, there is no failure threshold, and the status does not by itself stop the server being dialled for the next message. Read it as "the last attempt failed", not as "this server has been taken out of rotation" - the circuit breaker that would do the latter is planned, not built, and is tracked in layer5io/meshery-cloud#6057. `ignored` means an administrator turned it off.
+    /** Lifecycle and transport verdict, carrying the connection status vocabulary because the configuration IS a connection. `registered` means configured but never proven - the from domain is unverified, or no message has yet been delivered - and mail takes the provider relay. `connected` means the last delivery attempt succeeded and mail is routed through this server. `disconnected` means the most recent delivery attempt did not succeed, and `fallbackToProvider` governs what becomes of that message. It is a verdict on the last attempt alone: a SINGLE failure records it, there is no failure threshold, and the status does not by itself stop the server being dialled for the next message. Read it as "the last attempt failed", not as "this server has been taken out of rotation" - the circuit breaker that would do the latter is planned, not built, and is tracked in meshery-cloud#6057. `ignored` means an administrator turned it off.
       
       The writers are disjoint on purpose: only an administrator writes `ignored`, and only a delivery outcome writes `connected` or `disconnected`. That is what keeps a deliberate opt-out distinguishable from a failing relay. It also makes "enabled while the from domain is unverified" unrepresentable rather than merely forbidden, which is why this property replaces the separate `enabled` and `verificationState` pair it supersedes. */
     status: "registered" | "connected" | "disconnected" | "ignored";
@@ -662,7 +662,7 @@ type SetOrganizationSmtpEnablementApiResponse = {
     lastFailureAt?: string | null;
     /** Classification of the last failure. Always a classification, never the remote server's own message: the set is closed on purpose, because reporting a remote server's text back to a caller would turn a refusal into an oracle for what the network can reach. */
     lastFailureReason?: "blocked_target" | "connect_refused" | "connect_timeout" | "tls_failed" | "starttls_unsupported" | "auth_rejected" | "relay_rejected_sender" | "relay_rejected_recipient" | "delivery_failed" | "credential_unreadable";
-    /** Count of delivery attempts that have failed since the last success, reset to zero by a success. It is a RECORD and nothing more: no threshold reads it, and reaching any particular value does not itself stop a persistently unreachable server being dialled. A consumer must not treat a non-zero count as protection already in place. The circuit breaker that would consume this count - and which needs a threshold, a reset policy, and a decision about its interaction with `fallbackToProvider`, where an open circuit with fallback off drops account-verification and password-recovery mail - is planned under layer5io/meshery-cloud#6057. */
+    /** Count of delivery attempts that have failed since the last success, reset to zero by a success. It is a RECORD and nothing more: no threshold reads it, and reaching any particular value does not itself stop a persistently unreachable server being dialled. A consumer must not treat a non-zero count as protection already in place. The circuit breaker that would consume this count - and which needs a threshold, a reset policy, and a decision about its interaction with `fallbackToProvider`, where an open circuit with fallback off drops account-verification and password-recovery mail - is planned under meshery-cloud#6057. */
     consecutiveFailures: number;
     /** A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas. */
     createdBy?: string | null;
@@ -3074,7 +3074,7 @@ type GetUsersForOrgApiResponse = {
         roleNames?: string[];
         /** Teams the user belongs to with role information */
         teams?: {
-            /** Team memberships for the user with their assigned roles. */
+            /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             teamsWithRoles?: {
                 /** Unique identifier of the team. */
                 id: string;
@@ -3096,13 +3096,13 @@ type GetUsersForOrgApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of team memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
         /** Organizations the user belongs to with role information */
         organizations?: {
-            /** Organization memberships for the user with their assigned roles. */
+            /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             organizationsWithRoles?: {
                 /** Unique identifier of the organization. */
                 id: string;
@@ -3124,9 +3124,9 @@ type GetUsersForOrgApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of organization memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
     }[];
 };
@@ -3263,7 +3263,7 @@ type GetUserProfileByIdApiResponse = {
     roleNames?: string[];
     /** Teams the user belongs to with role information */
     teams?: {
-        /** Team memberships for the user with their assigned roles. */
+        /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
         teamsWithRoles?: {
             /** Unique identifier of the team. */
             id: string;
@@ -3285,13 +3285,13 @@ type GetUserProfileByIdApiResponse = {
             deletedAt?: string | null;
             /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
             roleNames: string[];
-        }[];
-        /** Total number of team memberships returned for the user. */
-        totalCount?: number;
+        }[] | null;
+        /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+        totalCount?: number | null;
     };
     /** Organizations the user belongs to with role information */
     organizations?: {
-        /** Organization memberships for the user with their assigned roles. */
+        /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
         organizationsWithRoles?: {
             /** Unique identifier of the organization. */
             id: string;
@@ -3313,9 +3313,9 @@ type GetUserProfileByIdApiResponse = {
             deletedAt?: string | null;
             /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
             roleNames: string[];
-        }[];
-        /** Total number of organization memberships returned for the user. */
-        totalCount?: number;
+        }[] | null;
+        /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+        totalCount?: number | null;
     };
 };
 type GetUserProfileByIdApiArg = {
@@ -3439,7 +3439,7 @@ type GetUserApiResponse = {
     roleNames?: string[];
     /** Teams the user belongs to with role information */
     teams?: {
-        /** Team memberships for the user with their assigned roles. */
+        /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
         teamsWithRoles?: {
             /** Unique identifier of the team. */
             id: string;
@@ -3461,13 +3461,13 @@ type GetUserApiResponse = {
             deletedAt?: string | null;
             /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
             roleNames: string[];
-        }[];
-        /** Total number of team memberships returned for the user. */
-        totalCount?: number;
+        }[] | null;
+        /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+        totalCount?: number | null;
     };
     /** Organizations the user belongs to with role information */
     organizations?: {
-        /** Organization memberships for the user with their assigned roles. */
+        /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
         organizationsWithRoles?: {
             /** Unique identifier of the organization. */
             id: string;
@@ -3489,9 +3489,9 @@ type GetUserApiResponse = {
             deletedAt?: string | null;
             /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
             roleNames: string[];
-        }[];
-        /** Total number of organization memberships returned for the user. */
-        totalCount?: number;
+        }[] | null;
+        /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+        totalCount?: number | null;
     };
 };
 type GetUserApiArg = void;
@@ -7913,7 +7913,7 @@ type GetPatternsApiResponse = {
             roleNames?: string[];
             /** Teams the user belongs to with role information */
             teams?: {
-                /** Team memberships for the user with their assigned roles. */
+                /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
                 teamsWithRoles?: {
                     /** Unique identifier of the team. */
                     id: string;
@@ -7935,13 +7935,13 @@ type GetPatternsApiResponse = {
                     deletedAt?: string | null;
                     /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
                     roleNames: string[];
-                }[];
-                /** Total number of team memberships returned for the user. */
-                totalCount?: number;
+                }[] | null;
+                /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+                totalCount?: number | null;
             };
             /** Organizations the user belongs to with role information */
             organizations?: {
-                /** Organization memberships for the user with their assigned roles. */
+                /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
                 organizationsWithRoles?: {
                     /** Unique identifier of the organization. */
                     id: string;
@@ -7963,9 +7963,9 @@ type GetPatternsApiResponse = {
                     deletedAt?: string | null;
                     /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
                     roleNames: string[];
-                }[];
-                /** Total number of organization memberships returned for the user. */
-                totalCount?: number;
+                }[] | null;
+                /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+                totalCount?: number | null;
             };
         } | null;
         /** Optional structured location metadata (branch, host, path, ...). */
@@ -8174,7 +8174,7 @@ type UpsertPatternApiResponse = {
         roleNames?: string[];
         /** Teams the user belongs to with role information */
         teams?: {
-            /** Team memberships for the user with their assigned roles. */
+            /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             teamsWithRoles?: {
                 /** Unique identifier of the team. */
                 id: string;
@@ -8196,13 +8196,13 @@ type UpsertPatternApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of team memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
         /** Organizations the user belongs to with role information */
         organizations?: {
-            /** Organization memberships for the user with their assigned roles. */
+            /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             organizationsWithRoles?: {
                 /** Unique identifier of the organization. */
                 id: string;
@@ -8224,9 +8224,9 @@ type UpsertPatternApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of organization memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
     } | null;
     /** Optional structured location metadata (branch, host, path, ...). */
@@ -8470,7 +8470,7 @@ type GetPatternApiResponse = {
         roleNames?: string[];
         /** Teams the user belongs to with role information */
         teams?: {
-            /** Team memberships for the user with their assigned roles. */
+            /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             teamsWithRoles?: {
                 /** Unique identifier of the team. */
                 id: string;
@@ -8492,13 +8492,13 @@ type GetPatternApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of team memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
         /** Organizations the user belongs to with role information */
         organizations?: {
-            /** Organization memberships for the user with their assigned roles. */
+            /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             organizationsWithRoles?: {
                 /** Unique identifier of the organization. */
                 id: string;
@@ -8520,9 +8520,9 @@ type GetPatternApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of organization memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
     } | null;
     /** Optional structured location metadata (branch, host, path, ...). */
@@ -8715,7 +8715,7 @@ type ClonePatternApiResponse = {
         roleNames?: string[];
         /** Teams the user belongs to with role information */
         teams?: {
-            /** Team memberships for the user with their assigned roles. */
+            /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             teamsWithRoles?: {
                 /** Unique identifier of the team. */
                 id: string;
@@ -8737,13 +8737,13 @@ type ClonePatternApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of team memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
         /** Organizations the user belongs to with role information */
         organizations?: {
-            /** Organization memberships for the user with their assigned roles. */
+            /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             organizationsWithRoles?: {
                 /** Unique identifier of the organization. */
                 id: string;
@@ -8765,9 +8765,9 @@ type ClonePatternApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of organization memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
     } | null;
     /** Optional structured location metadata (branch, host, path, ...). */
@@ -8965,7 +8965,7 @@ type ImportDesignApiResponse =
         roleNames?: string[];
         /** Teams the user belongs to with role information */
         teams?: {
-            /** Team memberships for the user with their assigned roles. */
+            /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             teamsWithRoles?: {
                 /** Unique identifier of the team. */
                 id: string;
@@ -8987,13 +8987,13 @@ type ImportDesignApiResponse =
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of team memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
         /** Organizations the user belongs to with role information */
         organizations?: {
-            /** Organization memberships for the user with their assigned roles. */
+            /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             organizationsWithRoles?: {
                 /** Unique identifier of the organization. */
                 id: string;
@@ -9015,9 +9015,9 @@ type ImportDesignApiResponse =
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of organization memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
     } | null;
     /** Optional structured location metadata (branch, host, path, ...). */
@@ -9222,7 +9222,7 @@ type GetCatalogContentApiResponse = {
             roleNames?: string[];
             /** Teams the user belongs to with role information */
             teams?: {
-                /** Team memberships for the user with their assigned roles. */
+                /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
                 teamsWithRoles?: {
                     /** Unique identifier of the team. */
                     id: string;
@@ -9244,13 +9244,13 @@ type GetCatalogContentApiResponse = {
                     deletedAt?: string | null;
                     /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
                     roleNames: string[];
-                }[];
-                /** Total number of team memberships returned for the user. */
-                totalCount?: number;
+                }[] | null;
+                /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+                totalCount?: number | null;
             };
             /** Organizations the user belongs to with role information */
             organizations?: {
-                /** Organization memberships for the user with their assigned roles. */
+                /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
                 organizationsWithRoles?: {
                     /** Unique identifier of the organization. */
                     id: string;
@@ -9272,9 +9272,9 @@ type GetCatalogContentApiResponse = {
                     deletedAt?: string | null;
                     /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
                     roleNames: string[];
-                }[];
-                /** Total number of organization memberships returned for the user. */
-                totalCount?: number;
+                }[] | null;
+                /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+                totalCount?: number | null;
             };
         } | null;
         /** Optional structured location metadata (branch, host, path, ...). */
@@ -9526,7 +9526,7 @@ type PublishCatalogContentApiResponse = {
         roleNames?: string[];
         /** Teams the user belongs to with role information */
         teams?: {
-            /** Team memberships for the user with their assigned roles. */
+            /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             teamsWithRoles?: {
                 /** Unique identifier of the team. */
                 id: string;
@@ -9548,13 +9548,13 @@ type PublishCatalogContentApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of team memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
         /** Organizations the user belongs to with role information */
         organizations?: {
-            /** Organization memberships for the user with their assigned roles. */
+            /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             organizationsWithRoles?: {
                 /** Unique identifier of the organization. */
                 id: string;
@@ -9576,9 +9576,9 @@ type PublishCatalogContentApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of organization memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
     } | null;
     /** Approval status of the request. */
@@ -9733,7 +9733,7 @@ type UnPublishCatalogContentApiResponse = {
         roleNames?: string[];
         /** Teams the user belongs to with role information */
         teams?: {
-            /** Team memberships for the user with their assigned roles. */
+            /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             teamsWithRoles?: {
                 /** Unique identifier of the team. */
                 id: string;
@@ -9755,13 +9755,13 @@ type UnPublishCatalogContentApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of team memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
         /** Organizations the user belongs to with role information */
         organizations?: {
-            /** Organization memberships for the user with their assigned roles. */
+            /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
             organizationsWithRoles?: {
                 /** Unique identifier of the organization. */
                 id: string;
@@ -9783,9 +9783,9 @@ type UnPublishCatalogContentApiResponse = {
                 deletedAt?: string | null;
                 /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
                 roleNames: string[];
-            }[];
-            /** Total number of organization memberships returned for the user. */
-            totalCount?: number;
+            }[] | null;
+            /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+            totalCount?: number | null;
         };
     } | null;
     /** Approval status of the request. */
@@ -10017,7 +10017,7 @@ type GetCatalogRequestApiResponse = {
             roleNames?: string[];
             /** Teams the user belongs to with role information */
             teams?: {
-                /** Team memberships for the user with their assigned roles. */
+                /** Team memberships for the user with their assigned roles. null means the team memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
                 teamsWithRoles?: {
                     /** Unique identifier of the team. */
                     id: string;
@@ -10039,13 +10039,13 @@ type GetCatalogRequestApiResponse = {
                     deletedAt?: string | null;
                     /** Names of the roles assigned to the user within this team. Free-form, user-generated role names; not a fixed enumeration. */
                     roleNames: string[];
-                }[];
-                /** Total number of team memberships returned for the user. */
-                totalCount?: number;
+                }[] | null;
+                /** Total number of team memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+                totalCount?: number | null;
             };
             /** Organizations the user belongs to with role information */
             organizations?: {
-                /** Organization memberships for the user with their assigned roles. */
+                /** Organization memberships for the user with their assigned roles. null means the organization memberships were not measured: the read failed, so the list is unknown. An empty array is only ever a measured absence of memberships. */
                 organizationsWithRoles?: {
                     /** Unique identifier of the organization. */
                     id: string;
@@ -10067,9 +10067,9 @@ type GetCatalogRequestApiResponse = {
                     deletedAt?: string | null;
                     /** Names of the roles assigned to the user within this organization. Free-form, user-generated role names; not a fixed enumeration. */
                     roleNames: string[];
-                }[];
-                /** Total number of organization memberships returned for the user. */
-                totalCount?: number;
+                }[] | null;
+                /** Total number of organization memberships for the user. null means the count was not measured: the membership read failed, so the value is unknown and must be presented as unknown, never as 0. A number, including 0, is always a measured value. */
+                totalCount?: number | null;
             };
         } | null;
         /** Approval status of the request. */