@datocms/cma-client 6.2.0 → 6.4.0

package/dist/types/generated/ApiTypes.d.ts

@@ -3095,9 +3095,9 @@ export type User = {
      */
     email: string;
     /**
-     * Whether 2-factor authentication is active for this account or not
+     * Whether 2-factor authentication is active for this account or not. It returns `null` if the credentials you are using cannot manage the collaborators of the project.
      */
-    is_2fa_active: boolean;
+    is_2fa_active: boolean | null;
     /**
      * Full name
      */
@@ -3120,7 +3120,7 @@ export type UserDestroyTargetSchema = User;
  */
 export type UserMeta = {
     /**
-     * Date of last reading/interaction
+     * Date of last reading/interaction. It returns `null` if the credentials you are using cannot manage the collaborators of the project.
      */
     last_access: string | null;
 };
@@ -3146,9 +3146,9 @@ export type UserAttributes = {
      */
     email: string;
     /**
-     * Whether 2-factor authentication is active for this account or not
+     * Whether 2-factor authentication is active for this account or not. It returns `null` if the credentials you are using cannot manage the collaborators of the project.
      */
-    is_2fa_active: boolean;
+    is_2fa_active: boolean | null;
     /**
      * Full name
      */
@@ -3194,7 +3194,7 @@ export type SsoUser = {
      */
     username: string;
     /**
-     * Identity provider ID
+     * Identity provider ID. It returns `null` if the credentials you are using cannot manage the SSO users of the project.
      */
     external_id: string | null;
     /**
@@ -3233,7 +3233,7 @@ export type SsoGroupData = {
  */
 export type SsoUserMeta = {
     /**
-     * Date of last reading/interaction
+     * Date of last reading/interaction. It returns `null` if the credentials you are using cannot manage the SSO users of the project.
      */
     last_access: string | null;
 };
@@ -3259,7 +3259,7 @@ export type SsoUserAttributes = {
      */
     username: string;
     /**
-     * Identity provider ID
+     * Identity provider ID. It returns `null` if the credentials you are using cannot manage the SSO users of the project.
      */
     external_id: string | null;
     /**
@@ -3328,13 +3328,13 @@ export type AccessToken = {
      */
     hardcoded_type: null | string;
     /**
-     * When this API token was last used to access the Content Management API
+     * When this API token was last used to access the Content Management API. It returns `null` if the credentials you are using cannot manage the API tokens of the project.
      */
-    last_cma_access: 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
+    last_cma_access: null | 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
     /**
-     * When this API token was last used to access the Content Delivery API
+     * When this API token was last used to access the Content Delivery API. It returns `null` if the credentials you are using cannot manage the API tokens of the project.
      */
-    last_cda_access: 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
+    last_cda_access: null | 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
     role: RoleData | null;
 };
 export type AccessTokenCreateTargetSchema = AccessToken;
@@ -3384,13 +3384,13 @@ export type AccessTokenAttributes = {
      */
     hardcoded_type: null | string;
     /**
-     * When this API token was last used to access the Content Management API
+     * When this API token was last used to access the Content Management API. It returns `null` if the credentials you are using cannot manage the API tokens of the project.
      */
-    last_cma_access: 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
+    last_cma_access: null | 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
     /**
-     * When this API token was last used to access the Content Delivery API
+     * When this API token was last used to access the Content Delivery API. It returns `null` if the credentials you are using cannot manage the API tokens of the project.
      */
-    last_cda_access: 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
+    last_cda_access: null | 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
 };
 /**
  * JSON API links
@@ -6788,9 +6788,9 @@ export type Plugin = {
      */
     url: string;
     /**
-     * Global plugin configuration. Plugins can persist whatever information they want in this object to reuse it later. Refer to the CMA for details about technical limits.
+     * Global plugin configuration. Plugins can persist whatever information they want in this object to reuse it later. Refer to the CMA for details about technical limits. It returns `null` if the credentials you are using cannot edit the schema of the project.
      */
-    parameters: {
+    parameters: null | {
         [k: string]: unknown;
     };
     /**
@@ -6872,9 +6872,9 @@ export type PluginAttributes = {
      */
     url: string;
     /**
-     * Global plugin configuration. Plugins can persist whatever information they want in this object to reuse it later. Refer to the CMA for details about technical limits.
+     * Global plugin configuration. Plugins can persist whatever information they want in this object to reuse it later. Refer to the CMA for details about technical limits. It returns `null` if the credentials you are using cannot edit the schema of the project.
      */
-    parameters: {
+    parameters: null | {
         [k: string]: unknown;
     };
     /**
@@ -8838,13 +8838,13 @@ export type Webhook = {
      */
     http_basic_user: string | null;
     /**
-     * HTTP Basic Authorization password
+     * HTTP Basic Authorization password. It is `null` when the webhook has no basic auth, or when the credentials you are using cannot manage the webhooks of the project.
      */
     http_basic_password: string | null;
     /**
-     * Additional headers that will be sent
+     * Additional headers that will be sent. It returns `null` if the credentials you are using cannot manage the webhooks of the project.
      */
-    headers: {
+    headers: null | {
         [k: string]: string;
     };
     events: {
@@ -8913,13 +8913,13 @@ export type WebhookAttributes = {
      */
     http_basic_user: string | null;
     /**
-     * HTTP Basic Authorization password
+     * HTTP Basic Authorization password. It is `null` when the webhook has no basic auth, or when the credentials you are using cannot manage the webhooks of the project.
      */
     http_basic_password: string | null;
     /**
-     * Additional headers that will be sent
+     * Additional headers that will be sent. It returns `null` if the credentials you are using cannot manage the webhooks of the project.
      */
-    headers: {
+    headers: null | {
         [k: string]: string;
     };
     events: {
@@ -8986,7 +8986,7 @@ export type WebhookCreateSchema = {
      */
     http_basic_user: string | null;
     /**
-     * HTTP Basic Authorization password
+     * HTTP Basic Authorization password. It is `null` when the webhook has no basic auth, or when the credentials you are using cannot manage the webhooks of the project.
      */
     http_basic_password: string | null;
     /**
@@ -9047,7 +9047,7 @@ export type WebhookUpdateSchema = {
      */
     http_basic_user?: string | null;
     /**
-     * HTTP Basic Authorization password
+     * HTTP Basic Authorization password. It is `null` when the webhook has no basic auth, or when the credentials you are using cannot manage the webhooks of the project.
      */
     http_basic_password?: string | null;
     /**
@@ -9240,9 +9240,9 @@ export type BuildTrigger = {
      */
     adapter: 'custom' | 'netlify' | 'vercel' | 'gitlab';
     /**
-     * Additional settings for the build trigger. The value depends on the `adapter`.
+     * Additional settings for the build trigger. The value depends on the `adapter`. It returns `null` if the credentials you are using cannot manage the build triggers of the project.
      */
-    adapter_settings: {
+    adapter_settings: null | {
         [k: string]: unknown;
     };
     /**
@@ -9254,13 +9254,13 @@ export type BuildTrigger = {
      */
     build_status: string;
     /**
-     * Unique token for the webhook (it's the same token present in `webhook_url`)
+     * Unique token for the webhook (it's the same token present in `webhook_url`). It returns `null` if the credentials you are using cannot manage the build triggers of the project.
      */
-    webhook_token?: string;
+    webhook_token: null | string;
     /**
-     * The URL of the webhook your service has to call when the build completes to report it's status (success or error)
+     * The URL of the webhook your service has to call when the build completes to report it's status (success or error). It returns `null` if the credentials you are using cannot manage the build triggers of the project.
      */
-    webhook_url: string;
+    webhook_url: null | string;
     /**
      * Status of Site Search for the frontend
      */
@@ -9302,9 +9302,9 @@ export type BuildTriggerAttributes = {
      */
     adapter: 'custom' | 'netlify' | 'vercel' | 'gitlab';
     /**
-     * Additional settings for the build trigger. The value depends on the `adapter`.
+     * Additional settings for the build trigger. The value depends on the `adapter`. It returns `null` if the credentials you are using cannot manage the build triggers of the project.
      */
-    adapter_settings: {
+    adapter_settings: null | {
         [k: string]: unknown;
     };
     /**
@@ -9316,13 +9316,13 @@ export type BuildTriggerAttributes = {
      */
     build_status: string;
     /**
-     * Unique token for the webhook (it's the same token present in `webhook_url`)
+     * Unique token for the webhook (it's the same token present in `webhook_url`). It returns `null` if the credentials you are using cannot manage the build triggers of the project.
      */
-    webhook_token?: string;
+    webhook_token: null | string;
     /**
-     * The URL of the webhook your service has to call when the build completes to report it's status (success or error)
+     * The URL of the webhook your service has to call when the build completes to report it's status (success or error). It returns `null` if the credentials you are using cannot manage the build triggers of the project.
      */
-    webhook_url: string;
+    webhook_url: null | string;
     /**
      * Status of Site Search for the frontend
      */
@@ -10985,7 +10985,7 @@ export type Site = {
      */
     domain: string | null;
     /**
-     * Google API Key to be used by the LatLon widget
+     * Google API Key to be used by the LatLon field editor. Only the DatoCMS interface uses it: it returns `null` for any other caller.
      */
     google_maps_api_token: string | null;
     /**
@@ -10993,7 +10993,7 @@ export type Site = {
      */
     imgix_host: string | null;
     /**
-     * DatoCMS internal domain for the administrative area
+     * DatoCMS internal domain for the administrative area. Returns `null` if the credentials you are using cannot read the configuration of the project.
      */
     internal_domain: string | null;
     /**
@@ -11017,13 +11017,13 @@ export type Site = {
      */
     last_data_change_at: null | string;
     /**
-     * Specifies whether all users of this site need to authenticate using two-factor authentication
+     * Specifies whether all users of this site need to authenticate using two-factor authentication. Returns `null` if the credentials you are using cannot read the configuration of the project.
      */
-    require_2fa: boolean;
+    require_2fa: boolean | null;
     /**
-     * Specifies whether you want IPs to be tracked in the Project usages section
+     * Specifies whether you want IPs to be tracked in the Project usages section. Returns `null` if the credentials you are using cannot read the configuration of the project.
      */
-    ip_tracking_enabled: boolean;
+    ip_tracking_enabled: boolean | null;
     /**
      * If enabled, blocks schema changes of primary environment
      */
@@ -11332,7 +11332,7 @@ export type SiteAttributes = {
      */
     domain: string | null;
     /**
-     * Google API Key to be used by the LatLon widget
+     * Google API Key to be used by the LatLon field editor. Only the DatoCMS interface uses it: it returns `null` for any other caller.
      */
     google_maps_api_token: string | null;
     /**
@@ -11340,7 +11340,7 @@ export type SiteAttributes = {
      */
     imgix_host: string | null;
     /**
-     * DatoCMS internal domain for the administrative area
+     * DatoCMS internal domain for the administrative area. Returns `null` if the credentials you are using cannot read the configuration of the project.
      */
     internal_domain: string | null;
     /**
@@ -11364,13 +11364,13 @@ export type SiteAttributes = {
      */
     last_data_change_at: null | string;
     /**
-     * Specifies whether all users of this site need to authenticate using two-factor authentication
+     * Specifies whether all users of this site need to authenticate using two-factor authentication. Returns `null` if the credentials you are using cannot read the configuration of the project.
      */
-    require_2fa: boolean;
+    require_2fa: boolean | null;
     /**
-     * Specifies whether you want IPs to be tracked in the Project usages section
+     * Specifies whether you want IPs to be tracked in the Project usages section. Returns `null` if the credentials you are using cannot read the configuration of the project.
      */
-    ip_tracking_enabled: boolean;
+    ip_tracking_enabled: boolean | null;
     /**
      * If enabled, blocks schema changes of primary environment
      */
@@ -11754,11 +11754,11 @@ export type SiteUpdateSchema = {
      */
     timezone?: string;
     /**
-     * Specifies whether all users of this site need to authenticate using two-factor authentication
+     * Specifies whether all users of this site need to authenticate using two-factor authentication.
      */
     require_2fa?: boolean;
     /**
-     * Specifies whether you want IPs to be tracked in the Project usages section
+     * Specifies whether you want IPs to be tracked in the Project usages section.
      */
     ip_tracking_enabled?: boolean;
     /**

package/dist/types/generated/RawApiTypes.d.ts

@@ -2688,9 +2688,9 @@ export type UserAttributes = {
      */
     email: string;
     /**
-     * Whether 2-factor authentication is active for this account or not
+     * Whether 2-factor authentication is active for this account or not. It returns `null` if the credentials you are using cannot manage the collaborators of the project.
      */
-    is_2fa_active: boolean;
+    is_2fa_active: boolean | null;
     /**
      * Full name
      */
@@ -2722,7 +2722,7 @@ export type UserRelationships = {
  */
 export type UserMeta = {
     /**
-     * Date of last reading/interaction
+     * Date of last reading/interaction. It returns `null` if the credentials you are using cannot manage the collaborators of the project.
      */
     last_access: string | null;
 };
@@ -2815,7 +2815,7 @@ export type SsoUserAttributes = {
      */
     username: string;
     /**
-     * Identity provider ID
+     * Identity provider ID. It returns `null` if the credentials you are using cannot manage the SSO users of the project.
      */
     external_id: string | null;
     /**
@@ -2869,7 +2869,7 @@ export type SsoGroupData = {
  */
 export type SsoUserMeta = {
     /**
-     * Date of last reading/interaction
+     * Date of last reading/interaction. It returns `null` if the credentials you are using cannot manage the SSO users of the project.
      */
     last_access: string | null;
 };
@@ -2964,13 +2964,13 @@ export type AccessTokenAttributes = {
      */
     hardcoded_type: null | string;
     /**
-     * When this API token was last used to access the Content Management API
+     * When this API token was last used to access the Content Management API. It returns `null` if the credentials you are using cannot manage the API tokens of the project.
      */
-    last_cma_access: 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
+    last_cma_access: null | 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
     /**
-     * When this API token was last used to access the Content Delivery API
+     * When this API token was last used to access the Content Delivery API. It returns `null` if the credentials you are using cannot manage the API tokens of the project.
      */
-    last_cda_access: 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
+    last_cda_access: null | 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'never';
 };
 /**
  * JSON API links
@@ -6620,9 +6620,9 @@ export type PluginAttributes = {
      */
     url: string;
     /**
-     * Global plugin configuration. Plugins can persist whatever information they want in this object to reuse it later. Refer to the CMA for details about technical limits.
+     * Global plugin configuration. Plugins can persist whatever information they want in this object to reuse it later. Refer to the CMA for details about technical limits. It returns `null` if the credentials you are using cannot edit the schema of the project.
      */
-    parameters: {
+    parameters: null | {
         [k: string]: unknown;
     };
     /**
@@ -9207,13 +9207,13 @@ export type WebhookAttributes = {
      */
     http_basic_user: string | null;
     /**
-     * HTTP Basic Authorization password
+     * HTTP Basic Authorization password. It is `null` when the webhook has no basic auth, or when the credentials you are using cannot manage the webhooks of the project.
      */
     http_basic_password: string | null;
     /**
-     * Additional headers that will be sent
+     * Additional headers that will be sent. It returns `null` if the credentials you are using cannot manage the webhooks of the project.
      */
-    headers: {
+    headers: null | {
         [k: string]: string;
     };
     events: {
@@ -9292,7 +9292,7 @@ export type WebhookCreateSchema = {
              */
             http_basic_user: string | null;
             /**
-             * HTTP Basic Authorization password
+             * HTTP Basic Authorization password. It is `null` when the webhook has no basic auth, or when the credentials you are using cannot manage the webhooks of the project.
              */
             http_basic_password: string | null;
             /**
@@ -9364,7 +9364,7 @@ export type WebhookUpdateSchema = {
              */
             http_basic_user?: string | null;
             /**
-             * HTTP Basic Authorization password
+             * HTTP Basic Authorization password. It is `null` when the webhook has no basic auth, or when the credentials you are using cannot manage the webhooks of the project.
              */
             http_basic_password?: string | null;
             /**
@@ -9564,9 +9564,9 @@ export type BuildTriggerAttributes = {
      */
     adapter: 'custom' | 'netlify' | 'vercel' | 'gitlab';
     /**
-     * Additional settings for the build trigger. The value depends on the `adapter`.
+     * Additional settings for the build trigger. The value depends on the `adapter`. It returns `null` if the credentials you are using cannot manage the build triggers of the project.
      */
-    adapter_settings: {
+    adapter_settings: null | {
         [k: string]: unknown;
     };
     /**
@@ -9578,13 +9578,13 @@ export type BuildTriggerAttributes = {
      */
     build_status: string;
     /**
-     * Unique token for the webhook (it's the same token present in `webhook_url`)
+     * Unique token for the webhook (it's the same token present in `webhook_url`). It returns `null` if the credentials you are using cannot manage the build triggers of the project.
      */
-    webhook_token?: string;
+    webhook_token: null | string;
     /**
-     * The URL of the webhook your service has to call when the build completes to report it's status (success or error)
+     * The URL of the webhook your service has to call when the build completes to report it's status (success or error). It returns `null` if the credentials you are using cannot manage the build triggers of the project.
      */
-    webhook_url: string;
+    webhook_url: null | string;
     /**
      * Status of Site Search for the frontend
      */
@@ -11417,7 +11417,7 @@ export type SiteAttributes = {
      */
     domain: string | null;
     /**
-     * Google API Key to be used by the LatLon widget
+     * Google API Key to be used by the LatLon field editor. Only the DatoCMS interface uses it: it returns `null` for any other caller.
      */
     google_maps_api_token: string | null;
     /**
@@ -11425,7 +11425,7 @@ export type SiteAttributes = {
      */
     imgix_host: string | null;
     /**
-     * DatoCMS internal domain for the administrative area
+     * DatoCMS internal domain for the administrative area. Returns `null` if the credentials you are using cannot read the configuration of the project.
      */
     internal_domain: string | null;
     /**
@@ -11449,13 +11449,13 @@ export type SiteAttributes = {
      */
     last_data_change_at: null | string;
     /**
-     * Specifies whether all users of this site need to authenticate using two-factor authentication
+     * Specifies whether all users of this site need to authenticate using two-factor authentication. Returns `null` if the credentials you are using cannot read the configuration of the project.
      */
-    require_2fa: boolean;
+    require_2fa: boolean | null;
     /**
-     * Specifies whether you want IPs to be tracked in the Project usages section
+     * Specifies whether you want IPs to be tracked in the Project usages section. Returns `null` if the credentials you are using cannot read the configuration of the project.
      */
-    ip_tracking_enabled: boolean;
+    ip_tracking_enabled: boolean | null;
     /**
      * If enabled, blocks schema changes of primary environment
      */
@@ -11929,11 +11929,11 @@ export type SiteUpdateSchema = {
              */
             timezone?: string;
             /**
-             * Specifies whether all users of this site need to authenticate using two-factor authentication
+             * Specifies whether all users of this site need to authenticate using two-factor authentication.
              */
             require_2fa?: boolean;
             /**
-             * Specifies whether you want IPs to be tracked in the Project usages section
+             * Specifies whether you want IPs to be tracked in the Project usages section.
              */
             ip_tracking_enabled?: boolean;
             /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datocms/cma-client",
-  "version": "6.2.0",
+  "version": "6.4.0",
   "description": "JS client for DatoCMS REST Content Management API",
   "keywords": [
     "datocms",
@@ -53,7 +53,7 @@
     "uuid": "^11.1.1"
   },
   "devDependencies": {
-    "@datocms/dashboard-client": "^6.1.0"
+    "@datocms/dashboard-client": "^6.4.0"
   },
   "gitHead": "ac4164968026ba62a2841d31d2b60c31eadb2cc8"
 }