@datocms/cma-client 0.1.6 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (31) hide show
  1. package/dist/cjs/generated/resources/Site.js +25 -3
  2. package/dist/cjs/generated/resources/Site.js.map +1 -1
  3. package/dist/cjs/generated/resources/User.js +26 -3
  4. package/dist/cjs/generated/resources/User.js.map +1 -1
  5. package/dist/esm/buildBlockRecord.d.ts +1 -1
  6. package/dist/esm/generated/SchemaTypes.d.ts +1294 -413
  7. package/dist/esm/generated/SimpleSchemaTypes.d.ts +1353 -501
  8. package/dist/esm/generated/resources/Site.d.ts +14 -2
  9. package/dist/esm/generated/resources/Site.js +25 -3
  10. package/dist/esm/generated/resources/Site.js.map +1 -1
  11. package/dist/esm/generated/resources/User.d.ts +14 -2
  12. package/dist/esm/generated/resources/User.js +26 -3
  13. package/dist/esm/generated/resources/User.js.map +1 -1
  14. package/dist/types/buildBlockRecord.d.ts +1 -1
  15. package/dist/types/generated/SchemaTypes.d.ts +1294 -413
  16. package/dist/types/generated/SimpleSchemaTypes.d.ts +1353 -501
  17. package/dist/types/generated/resources/Site.d.ts +14 -2
  18. package/dist/types/generated/resources/User.d.ts +14 -2
  19. package/package.json +6 -5
  20. package/resources.json +1278 -0
  21. package/src/generated/SchemaTypes.ts +1311 -426
  22. package/src/generated/SimpleSchemaTypes.ts +1352 -499
  23. package/src/generated/resources/Site.ts +33 -3
  24. package/src/generated/resources/User.ts +36 -3
  25. package/dist/cjs/generated/schemaInfo.js +0 -3093
  26. package/dist/cjs/generated/schemaInfo.js.map +0 -1
  27. package/dist/esm/generated/schemaInfo.d.ts +0 -940
  28. package/dist/esm/generated/schemaInfo.js +0 -3091
  29. package/dist/esm/generated/schemaInfo.js.map +0 -1
  30. package/dist/types/generated/schemaInfo.d.ts +0 -940
  31. package/src/generated/schemaInfo.ts +0 -3263
@@ -87,19 +87,20 @@ export declare type UserType = 'user';
87
87
  export declare type UserInstancesTargetSchema = User[];
88
88
  /**
89
89
  * This interface was referenced by `User`'s JSON-Schema
90
- * via the `destroy.hrefSchema` link.
90
+ * via the `self.hrefSchema` link.
91
91
  */
92
- export declare type UserDestroyHrefSchema = {
93
- /**
94
- * New owner for resources previously owned by the deleted user. This argument specifies the new owner type.
95
- */
96
- destination_user_type?: 'account' | 'user' | 'access_token' | 'sso_user';
92
+ export declare type UserSelfHrefSchema = {
97
93
  /**
98
- * New owner for resources previously owned by the deleted user. This argument specifies the new owner ID.
94
+ * Comma-separated list of [relationship paths](https://jsonapi.org/format/#fetching-includes). A relationship path is a dot-separated list of relationship names. Allowed relationship paths: `role`.
99
95
  */
100
- destination_user_id?: string;
96
+ include?: string;
101
97
  [k: string]: unknown;
102
98
  };
99
+ /**
100
+ * This interface was referenced by `User`'s JSON-Schema
101
+ * via the `me.targetSchema` link.
102
+ */
103
+ export declare type UserMeTargetSchema = User | SsoUser | AccessToken | Account;
103
104
  /**
104
105
  * ID of user
105
106
  *
@@ -160,27 +161,42 @@ export declare type SsoUserDestroyHrefSchema = {
160
161
  [k: string]: unknown;
161
162
  };
162
163
  /**
163
- * ULID of event (https://github.com/ulid/spec)
164
+ * ID of access_token
164
165
  *
165
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
166
+ * This interface was referenced by `AccessToken`'s JSON-Schema
166
167
  * via the `definition` "identity".
167
168
  *
168
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
169
+ * This interface was referenced by `AccessToken`'s JSON-Schema
169
170
  * via the `definition` "id".
170
171
  */
171
- export declare type AuditLogEventIdentity = string;
172
+ export declare type AccessTokenIdentity = string;
172
173
  /**
173
174
  * JSON API type field
174
175
  *
175
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
176
+ * This interface was referenced by `AccessToken`'s JSON-Schema
176
177
  * via the `definition` "type".
177
178
  */
178
- export declare type AuditLogEventType = 'audit_log_event';
179
+ export declare type AccessTokenType = 'access_token';
179
180
  /**
180
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
181
- * via the `query.targetSchema` link.
181
+ * This interface was referenced by `AccessToken`'s JSON-Schema
182
+ * via the `instances.targetSchema` link.
182
183
  */
183
- export declare type AuditLogEventQueryTargetSchema = AuditLogEvent[];
184
+ export declare type AccessTokenInstancesTargetSchema = AccessToken[];
185
+ /**
186
+ * This interface was referenced by `AccessToken`'s JSON-Schema
187
+ * via the `destroy.hrefSchema` link.
188
+ */
189
+ export declare type AccessTokenDestroyHrefSchema = {
190
+ /**
191
+ * New owner for resources previously owned by the deleted access token. This argument specifies the new owner type.
192
+ */
193
+ destination_user_type?: 'account' | 'user' | 'access_token' | 'sso_user';
194
+ /**
195
+ * New owner for resources previously owned by the deleted access token. This argument specifies the new owner ID.
196
+ */
197
+ destination_user_id?: string;
198
+ [k: string]: unknown;
199
+ };
184
200
  /**
185
201
  * ID of account
186
202
  *
@@ -198,6 +214,54 @@ export declare type AccountIdentity = string;
198
214
  * via the `definition` "type".
199
215
  */
200
216
  export declare type AccountType = 'account';
217
+ /**
218
+ * This interface was referenced by `User`'s JSON-Schema
219
+ * via the `me.hrefSchema` link.
220
+ */
221
+ export declare type UserMeHrefSchema = {
222
+ /**
223
+ * Comma-separated list of [relationship paths](https://jsonapi.org/format/#fetching-includes). A relationship path is a dot-separated list of relationship names. Allowed relationship paths: `role`.
224
+ */
225
+ include?: string;
226
+ [k: string]: unknown;
227
+ };
228
+ /**
229
+ * This interface was referenced by `User`'s JSON-Schema
230
+ * via the `destroy.hrefSchema` link.
231
+ */
232
+ export declare type UserDestroyHrefSchema = {
233
+ /**
234
+ * New owner for resources previously owned by the deleted user. This argument specifies the new owner type.
235
+ */
236
+ destination_user_type?: 'account' | 'user' | 'access_token' | 'sso_user';
237
+ /**
238
+ * New owner for resources previously owned by the deleted user. This argument specifies the new owner ID.
239
+ */
240
+ destination_user_id?: string;
241
+ [k: string]: unknown;
242
+ };
243
+ /**
244
+ * ULID of event (https://github.com/ulid/spec)
245
+ *
246
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
247
+ * via the `definition` "identity".
248
+ *
249
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
250
+ * via the `definition` "id".
251
+ */
252
+ export declare type AuditLogEventIdentity = string;
253
+ /**
254
+ * JSON API type field
255
+ *
256
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
257
+ * via the `definition` "type".
258
+ */
259
+ export declare type AuditLogEventType = 'audit_log_event';
260
+ /**
261
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
262
+ * via the `query.targetSchema` link.
263
+ */
264
+ export declare type AuditLogEventQueryTargetSchema = AuditLogEvent[];
201
265
  /**
202
266
  * ID of plan
203
267
  *
@@ -290,6 +354,23 @@ export declare type FieldType = 'field';
290
354
  * via the `definition` "id".
291
355
  */
292
356
  export declare type FieldIdentity = string;
357
+ /**
358
+ * JSON API type fieldset
359
+ *
360
+ * This interface was referenced by `Fieldset`'s JSON-Schema
361
+ * via the `definition` "type".
362
+ */
363
+ export declare type FieldsetType = 'fieldset';
364
+ /**
365
+ * ID of fieldset
366
+ *
367
+ * This interface was referenced by `Fieldset`'s JSON-Schema
368
+ * via the `definition` "identity".
369
+ *
370
+ * This interface was referenced by `Fieldset`'s JSON-Schema
371
+ * via the `definition` "id".
372
+ */
373
+ export declare type FieldsetIdentity = string;
293
374
  /**
294
375
  * JSON API type field
295
376
  *
@@ -319,23 +400,6 @@ export declare type JobType = 'job';
319
400
  * via the `instances.targetSchema` link.
320
401
  */
321
402
  export declare type ItemTypeInstancesTargetSchema = ItemType[];
322
- /**
323
- * JSON API type fieldset
324
- *
325
- * This interface was referenced by `Fieldset`'s JSON-Schema
326
- * via the `definition` "type".
327
- */
328
- export declare type FieldsetType = 'fieldset';
329
- /**
330
- * ID of fieldset
331
- *
332
- * This interface was referenced by `Fieldset`'s JSON-Schema
333
- * via the `definition` "identity".
334
- *
335
- * This interface was referenced by `Fieldset`'s JSON-Schema
336
- * via the `definition` "id".
337
- */
338
- export declare type FieldsetIdentity = string;
339
403
  /**
340
404
  * This interface was referenced by `Field`'s JSON-Schema
341
405
  * via the `instances.targetSchema` link.
@@ -373,43 +437,6 @@ export declare type SessionIdentity = string;
373
437
  * via the `definition` "type".
374
438
  */
375
439
  export declare type SessionType = 'session';
376
- /**
377
- * ID of access_token
378
- *
379
- * This interface was referenced by `AccessToken`'s JSON-Schema
380
- * via the `definition` "identity".
381
- *
382
- * This interface was referenced by `AccessToken`'s JSON-Schema
383
- * via the `definition` "id".
384
- */
385
- export declare type AccessTokenIdentity = string;
386
- /**
387
- * JSON API type field
388
- *
389
- * This interface was referenced by `AccessToken`'s JSON-Schema
390
- * via the `definition` "type".
391
- */
392
- export declare type AccessTokenType = 'access_token';
393
- /**
394
- * This interface was referenced by `AccessToken`'s JSON-Schema
395
- * via the `instances.targetSchema` link.
396
- */
397
- export declare type AccessTokenInstancesTargetSchema = AccessToken[];
398
- /**
399
- * This interface was referenced by `AccessToken`'s JSON-Schema
400
- * via the `destroy.hrefSchema` link.
401
- */
402
- export declare type AccessTokenDestroyHrefSchema = {
403
- /**
404
- * New owner for resources previously owned by the deleted access token. This argument specifies the new owner type.
405
- */
406
- destination_user_type?: 'account' | 'user' | 'access_token' | 'sso_user';
407
- /**
408
- * New owner for resources previously owned by the deleted access token. This argument specifies the new owner ID.
409
- */
410
- destination_user_id?: string;
411
- [k: string]: unknown;
412
- };
413
440
  /**
414
441
  * ID of plugin
415
442
  *
@@ -1463,6 +1490,17 @@ export declare type SiteIdentity = string;
1463
1490
  * via the `definition` "type".
1464
1491
  */
1465
1492
  export declare type SiteType = 'site';
1493
+ /**
1494
+ * This interface was referenced by `Site`'s JSON-Schema
1495
+ * via the `self.hrefSchema` link.
1496
+ */
1497
+ export declare type SiteSelfHrefSchema = {
1498
+ /**
1499
+ * Comma-separated list of [relationship paths](https://jsonapi.org/format/#fetching-includes). A relationship path is a dot-separated list of relationship names. Allowed relationship paths: `item_types`, `item_types.fields`, `item_types.fieldsets`, `item_types.singleton_item`, `account`.
1500
+ */
1501
+ include?: string;
1502
+ [k: string]: unknown;
1503
+ };
1466
1504
  /**
1467
1505
  * This interface was referenced by `Workflow`'s JSON-Schema
1468
1506
  * via the `instances.targetSchema` link.
@@ -2711,130 +2749,216 @@ export declare type SsoUserRelationships = {
2711
2749
  role: RoleData | null;
2712
2750
  };
2713
2751
  /**
2714
- * If the Audit log functionality is enabled in a project, logged events can be queried using SQL-like language and fetched in full detail so that they can be exported or analyzed.
2752
+ * An API token allows access to our API. It is linked to a Role, which describes what actions can be performed.
2715
2753
  *
2716
2754
  * This interface was referenced by `DatoApi`'s JSON-Schema
2717
- * via the `definition` "audit_log_event".
2755
+ * via the `definition` "access_token".
2718
2756
  */
2719
- export declare type AuditLogEvent = {
2720
- id: AuditLogEventIdentity;
2721
- type: AuditLogEventType;
2722
- /**
2723
- * The actual action performed
2724
- */
2725
- action_name: string;
2757
+ export declare type AccessToken = {
2758
+ id: AccessTokenIdentity;
2759
+ type: AccessTokenType;
2726
2760
  /**
2727
- * The actor who performed the action
2761
+ * Name of API token
2728
2762
  */
2729
- actor: {
2730
- /**
2731
- * The type of actor (can be `account`, `user`, `sso_user` or `access_token`)
2732
- */
2733
- type: string;
2734
- /**
2735
- * The ID of the actor
2736
- */
2737
- id: string;
2738
- /**
2739
- * An human representation of the actor (name/email/username depending on the type of actor)
2740
- */
2741
- name: string;
2742
- };
2763
+ name: string;
2743
2764
  /**
2744
- * The role of the actor at the time the action was performed
2765
+ * The actual API token (or null if the current user has no permission to read the token)
2745
2766
  */
2746
- role: null | {
2747
- /**
2748
- * The name of the role
2749
- */
2750
- name: string;
2751
- /**
2752
- * The ID of the role
2753
- */
2754
- id: string;
2755
- };
2767
+ token?: null | string;
2756
2768
  /**
2757
- * The environment inside of which the action was performed
2769
+ * Whether this API token can access the Content Delivery API published content endpoint
2758
2770
  */
2759
- environment: {
2760
- /**
2761
- * The ID of the environment
2762
- */
2763
- id: string;
2764
- /**
2765
- * Whether the environment was the primary one at the time the action was performed
2766
- */
2767
- primary: boolean;
2768
- };
2771
+ can_access_cda: boolean;
2769
2772
  /**
2770
- * The actual request being performed
2773
+ * Whether this API token can access the Content Delivery API draft content endpoint
2771
2774
  */
2772
- request: {
2773
- /**
2774
- * The full path of the request
2775
- */
2776
- path: string;
2777
- /**
2778
- * The HTTP method of the request
2779
- */
2780
- method: string;
2781
- /**
2782
- * The X-Request-ID header of the request
2783
- */
2784
- id?: string;
2785
- /**
2786
- * The full HTTP body of the request
2787
- */
2788
- payload?: null | {
2789
- [k: string]: unknown;
2790
- };
2791
- };
2775
+ can_access_cda_preview: boolean;
2792
2776
  /**
2793
- * The actual response being returned by DatoCMS
2777
+ * Whether this API token can access the Content Management API
2794
2778
  */
2795
- response: null | {
2796
- /**
2797
- * The HTTP status code of the response
2798
- */
2799
- status: number;
2800
- /**
2801
- * The full HTTP body of the response
2802
- */
2803
- payload: {
2804
- [k: string]: unknown;
2805
- };
2806
- };
2807
- meta: AuditLogEventMeta;
2779
+ can_access_cma: boolean;
2780
+ hardcoded_type: null | string;
2781
+ role: RoleData | null;
2808
2782
  };
2783
+ export declare type AccessTokenCreateTargetSchema = AccessToken;
2784
+ export declare type AccessTokenUpdateTargetSchema = AccessToken;
2785
+ export declare type AccessTokenSelfTargetSchema = AccessToken;
2786
+ export declare type AccessTokenRegenerateTokenTargetSchema = AccessToken;
2787
+ export declare type AccessTokenDestroyTargetSchema = AccessToken;
2809
2788
  /**
2810
- * JSON API meta
2789
+ * JSON API data
2811
2790
  *
2812
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
2813
- * via the `definition` "meta".
2791
+ * This interface was referenced by `AccessToken`'s JSON-Schema
2792
+ * via the `definition` "data".
2814
2793
  */
2815
- export declare type AuditLogEventMeta = {
2794
+ export declare type AccessTokenData = {
2795
+ type: AccessTokenType;
2796
+ id: AccessTokenIdentity;
2797
+ };
2798
+ /**
2799
+ * JSON API attributes
2800
+ *
2801
+ * This interface was referenced by `AccessToken`'s JSON-Schema
2802
+ * via the `definition` "attributes".
2803
+ */
2804
+ export declare type AccessTokenAttributes = {
2816
2805
  /**
2817
- * The date of the event
2806
+ * Name of API token
2818
2807
  */
2819
- occurred_at: string;
2808
+ name: string;
2809
+ /**
2810
+ * The actual API token (or null if the current user has no permission to read the token)
2811
+ */
2812
+ token?: null | string;
2813
+ /**
2814
+ * Whether this API token can access the Content Delivery API published content endpoint
2815
+ */
2816
+ can_access_cda: boolean;
2817
+ /**
2818
+ * Whether this API token can access the Content Delivery API draft content endpoint
2819
+ */
2820
+ can_access_cda_preview: boolean;
2821
+ /**
2822
+ * Whether this API token can access the Content Management API
2823
+ */
2824
+ can_access_cma: boolean;
2825
+ hardcoded_type: null | string;
2826
+ };
2827
+ /**
2828
+ * JSON API links
2829
+ *
2830
+ * This interface was referenced by `AccessToken`'s JSON-Schema
2831
+ * via the `definition` "relationships".
2832
+ */
2833
+ export declare type AccessTokenRelationships = {
2834
+ role: RoleData | null;
2835
+ };
2836
+ /**
2837
+ * This interface was referenced by `AccessToken`'s JSON-Schema
2838
+ * via the `create.schema` link.
2839
+ */
2840
+ export declare type AccessTokenCreateSchema = {
2841
+ type?: AccessTokenType;
2842
+ /**
2843
+ * Name of API token
2844
+ */
2845
+ name: string;
2846
+ /**
2847
+ * Whether this API token can access the Content Delivery API published content endpoint
2848
+ */
2849
+ can_access_cda: boolean;
2850
+ /**
2851
+ * Whether this API token can access the Content Delivery API draft content endpoint
2852
+ */
2853
+ can_access_cda_preview: boolean;
2854
+ /**
2855
+ * Whether this API token can access the Content Management API
2856
+ */
2857
+ can_access_cma: boolean;
2858
+ role: RoleData | null;
2859
+ };
2860
+ /**
2861
+ * This interface was referenced by `AccessToken`'s JSON-Schema
2862
+ * via the `update.schema` link.
2863
+ */
2864
+ export declare type AccessTokenUpdateSchema = {
2865
+ id?: AccessTokenIdentity;
2866
+ type?: AccessTokenType;
2867
+ /**
2868
+ * Name of API token
2869
+ */
2870
+ name: string;
2871
+ /**
2872
+ * Whether this API token can access the Content Delivery API published content endpoint
2873
+ */
2874
+ can_access_cda: boolean;
2875
+ /**
2876
+ * Whether this API token can access the Content Delivery API draft content endpoint
2877
+ */
2878
+ can_access_cda_preview: boolean;
2879
+ /**
2880
+ * Whether this API token can access the Content Management API
2881
+ */
2882
+ can_access_cma: boolean;
2883
+ role: RoleData | null;
2884
+ };
2885
+ /**
2886
+ * DatoCMS account
2887
+ *
2888
+ * This interface was referenced by `DatoApi`'s JSON-Schema
2889
+ * via the `definition` "account".
2890
+ */
2891
+ export declare type Account = {
2892
+ id: AccountIdentity;
2893
+ type: AccountType;
2894
+ /**
2895
+ * Email
2896
+ */
2897
+ email: string;
2898
+ /**
2899
+ * First name
2900
+ */
2901
+ first_name: string | null;
2902
+ /**
2903
+ * Last name
2904
+ */
2905
+ last_name: string | null;
2906
+ /**
2907
+ * Company name
2908
+ */
2909
+ company: string | null;
2910
+ /**
2911
+ * Password
2912
+ */
2913
+ password?: string;
2820
2914
  };
2821
2915
  /**
2822
2916
  * JSON API data
2823
2917
  *
2824
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
2918
+ * This interface was referenced by `Account`'s JSON-Schema
2825
2919
  * via the `definition` "data".
2826
2920
  */
2827
- export declare type AuditLogEventData = {
2828
- type: AuditLogEventType;
2829
- id: AuditLogEventIdentity;
2921
+ export declare type AccountData = {
2922
+ type: AccountType;
2923
+ id: AccountIdentity;
2830
2924
  };
2831
2925
  /**
2832
2926
  * JSON API attributes
2833
2927
  *
2834
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
2928
+ * This interface was referenced by `Account`'s JSON-Schema
2835
2929
  * via the `definition` "attributes".
2836
2930
  */
2837
- export declare type AuditLogEventAttributes = {
2931
+ export declare type AccountAttributes = {
2932
+ /**
2933
+ * Email
2934
+ */
2935
+ email: string;
2936
+ /**
2937
+ * First name
2938
+ */
2939
+ first_name: string | null;
2940
+ /**
2941
+ * Last name
2942
+ */
2943
+ last_name: string | null;
2944
+ /**
2945
+ * Company name
2946
+ */
2947
+ company: string | null;
2948
+ /**
2949
+ * Password
2950
+ */
2951
+ password?: string;
2952
+ };
2953
+ /**
2954
+ * If the Audit log functionality is enabled in a project, logged events can be queried using SQL-like language and fetched in full detail so that they can be exported or analyzed.
2955
+ *
2956
+ * This interface was referenced by `DatoApi`'s JSON-Schema
2957
+ * via the `definition` "audit_log_event".
2958
+ */
2959
+ export declare type AuditLogEvent = {
2960
+ id: AuditLogEventIdentity;
2961
+ type: AuditLogEventType;
2838
2962
  /**
2839
2963
  * The actual action performed
2840
2964
  */
@@ -2920,96 +3044,144 @@ export declare type AuditLogEventAttributes = {
2920
3044
  [k: string]: unknown;
2921
3045
  };
2922
3046
  };
3047
+ meta: AuditLogEventMeta;
2923
3048
  };
2924
3049
  /**
2925
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
2926
- * via the `query.schema` link.
2927
- */
2928
- export declare type AuditLogEventQuerySchema = {
2929
- /**
2930
- * JSON API type field
2931
- */
2932
- type?: 'audit_log_query';
2933
- /**
2934
- * An SQL-like expression to filter the events
2935
- */
2936
- filter?: string;
2937
- /**
2938
- * Set this value to get remaining results, if a meta.next_token was returned in the previous query response
2939
- */
2940
- next_token?: string;
2941
- /**
2942
- * Whether a detailed log complete with full request and response payload must be returned or not
2943
- */
2944
- detailed_log?: boolean;
2945
- };
2946
- /**
2947
- * DatoCMS account
3050
+ * JSON API meta
2948
3051
  *
2949
- * This interface was referenced by `DatoApi`'s JSON-Schema
2950
- * via the `definition` "account".
3052
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
3053
+ * via the `definition` "meta".
2951
3054
  */
2952
- export declare type Account = {
2953
- id: AccountIdentity;
2954
- type: AccountType;
2955
- /**
2956
- * Email
2957
- */
2958
- email: string;
2959
- /**
2960
- * First name
2961
- */
2962
- first_name: string | null;
2963
- /**
2964
- * Last name
2965
- */
2966
- last_name: string | null;
2967
- /**
2968
- * Company name
2969
- */
2970
- company: string | null;
3055
+ export declare type AuditLogEventMeta = {
2971
3056
  /**
2972
- * Password
3057
+ * The date of the event
2973
3058
  */
2974
- password?: string;
3059
+ occurred_at: string;
2975
3060
  };
2976
3061
  /**
2977
3062
  * JSON API data
2978
3063
  *
2979
- * This interface was referenced by `Account`'s JSON-Schema
3064
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
2980
3065
  * via the `definition` "data".
2981
3066
  */
2982
- export declare type AccountData = {
2983
- type: AccountType;
2984
- id: AccountIdentity;
3067
+ export declare type AuditLogEventData = {
3068
+ type: AuditLogEventType;
3069
+ id: AuditLogEventIdentity;
2985
3070
  };
2986
3071
  /**
2987
3072
  * JSON API attributes
2988
3073
  *
2989
- * This interface was referenced by `Account`'s JSON-Schema
3074
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
2990
3075
  * via the `definition` "attributes".
2991
3076
  */
2992
- export declare type AccountAttributes = {
2993
- /**
2994
- * Email
2995
- */
2996
- email: string;
3077
+ export declare type AuditLogEventAttributes = {
2997
3078
  /**
2998
- * First name
3079
+ * The actual action performed
2999
3080
  */
3000
- first_name: string | null;
3081
+ action_name: string;
3001
3082
  /**
3002
- * Last name
3083
+ * The actor who performed the action
3003
3084
  */
3004
- last_name: string | null;
3085
+ actor: {
3086
+ /**
3087
+ * The type of actor (can be `account`, `user`, `sso_user` or `access_token`)
3088
+ */
3089
+ type: string;
3090
+ /**
3091
+ * The ID of the actor
3092
+ */
3093
+ id: string;
3094
+ /**
3095
+ * An human representation of the actor (name/email/username depending on the type of actor)
3096
+ */
3097
+ name: string;
3098
+ };
3005
3099
  /**
3006
- * Company name
3100
+ * The role of the actor at the time the action was performed
3007
3101
  */
3008
- company: string | null;
3102
+ role: null | {
3103
+ /**
3104
+ * The name of the role
3105
+ */
3106
+ name: string;
3107
+ /**
3108
+ * The ID of the role
3109
+ */
3110
+ id: string;
3111
+ };
3009
3112
  /**
3010
- * Password
3113
+ * The environment inside of which the action was performed
3011
3114
  */
3012
- password?: string;
3115
+ environment: {
3116
+ /**
3117
+ * The ID of the environment
3118
+ */
3119
+ id: string;
3120
+ /**
3121
+ * Whether the environment was the primary one at the time the action was performed
3122
+ */
3123
+ primary: boolean;
3124
+ };
3125
+ /**
3126
+ * The actual request being performed
3127
+ */
3128
+ request: {
3129
+ /**
3130
+ * The full path of the request
3131
+ */
3132
+ path: string;
3133
+ /**
3134
+ * The HTTP method of the request
3135
+ */
3136
+ method: string;
3137
+ /**
3138
+ * The X-Request-ID header of the request
3139
+ */
3140
+ id?: string;
3141
+ /**
3142
+ * The full HTTP body of the request
3143
+ */
3144
+ payload?: null | {
3145
+ [k: string]: unknown;
3146
+ };
3147
+ };
3148
+ /**
3149
+ * The actual response being returned by DatoCMS
3150
+ */
3151
+ response: null | {
3152
+ /**
3153
+ * The HTTP status code of the response
3154
+ */
3155
+ status: number;
3156
+ /**
3157
+ * The full HTTP body of the response
3158
+ */
3159
+ payload: {
3160
+ [k: string]: unknown;
3161
+ };
3162
+ };
3163
+ };
3164
+ /**
3165
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
3166
+ * via the `query.schema` link.
3167
+ */
3168
+ export declare type AuditLogEventQuerySchema = {
3169
+ /**
3170
+ * JSON API type field
3171
+ */
3172
+ type?: 'audit_log_query';
3173
+ /**
3174
+ * An SQL-like expression to filter the events
3175
+ */
3176
+ filter?: string;
3177
+ /**
3178
+ * Set this value to get remaining results, if a meta.next_token was returned in the previous query response
3179
+ */
3180
+ next_token?: string;
3181
+ /**
3182
+ * Whether a detailed log complete with full request and response payload must be returned or not
3183
+ */
3184
+ detailed_log?: boolean;
3013
3185
  };
3014
3186
  /**
3015
3187
  * Stores the information regarding the current plan for the project.
@@ -3164,6 +3336,10 @@ export declare type SitePlan = {
3164
3336
  * Whether translator roles are enabled or not
3165
3337
  */
3166
3338
  translator_roles: boolean;
3339
+ /**
3340
+ * Whether or not use a static IP when sending webhooks
3341
+ */
3342
+ static_webhooks_ip: boolean;
3167
3343
  /**
3168
3344
  * Available extra packets
3169
3345
  */
@@ -3380,6 +3556,10 @@ export declare type SitePlanAttributes = {
3380
3556
  * Whether translator roles are enabled or not
3381
3557
  */
3382
3558
  translator_roles: boolean;
3559
+ /**
3560
+ * Whether or not use a static IP when sending webhooks
3561
+ */
3562
+ static_webhooks_ip: boolean;
3383
3563
  /**
3384
3564
  * Available extra packets
3385
3565
  */
@@ -3641,6 +3821,7 @@ export declare type ItemType = {
3641
3821
  hint: string | null;
3642
3822
  singleton_item: ItemData | null;
3643
3823
  fields: FieldData[];
3824
+ fieldsets: FieldsetData[];
3644
3825
  title_field: FieldData | null;
3645
3826
  image_preview_field: FieldData | null;
3646
3827
  excerpt_field: FieldData | null;
@@ -3672,6 +3853,16 @@ export declare type FieldData = {
3672
3853
  type: FieldType;
3673
3854
  id: FieldIdentity;
3674
3855
  };
3856
+ /**
3857
+ * JSON API data
3858
+ *
3859
+ * This interface was referenced by `Fieldset`'s JSON-Schema
3860
+ * via the `definition` "data".
3861
+ */
3862
+ export declare type FieldsetData = {
3863
+ type: FieldsetType;
3864
+ id: FieldsetIdentity;
3865
+ };
3675
3866
  /**
3676
3867
  * JSON API data
3677
3868
  *
@@ -3755,6 +3946,7 @@ export declare type ItemTypeAttributes = {
3755
3946
  export declare type ItemTypeRelationships = {
3756
3947
  singleton_item: ItemData | null;
3757
3948
  fields: FieldData[];
3949
+ fieldsets: FieldsetData[];
3758
3950
  title_field: FieldData | null;
3759
3951
  image_preview_field: FieldData | null;
3760
3952
  excerpt_field: FieldData | null;
@@ -3919,93 +4111,929 @@ export declare type ItemTypeUpdateSchema = {
3919
4111
  * This interface was referenced by `Item`'s JSON-Schema
3920
4112
  * via the `destroy.targetSchema` link.
3921
4113
  *
3922
- * This interface was referenced by `Item`'s JSON-Schema
3923
- * via the `batch_destroy.targetSchema` link.
4114
+ * This interface was referenced by `Item`'s JSON-Schema
4115
+ * via the `batch_destroy.targetSchema` link.
4116
+ *
4117
+ * This interface was referenced by `Item`'s JSON-Schema
4118
+ * via the `batch_publish.targetSchema` link.
4119
+ *
4120
+ * This interface was referenced by `Item`'s JSON-Schema
4121
+ * via the `batch_unpublish.targetSchema` link.
4122
+ *
4123
+ * This interface was referenced by `Item`'s JSON-Schema
4124
+ * via the `bulk_publish.targetSchema` link.
4125
+ *
4126
+ * This interface was referenced by `Item`'s JSON-Schema
4127
+ * via the `bulk_unpublish.targetSchema` link.
4128
+ *
4129
+ * This interface was referenced by `Item`'s JSON-Schema
4130
+ * via the `bulk_destroy.targetSchema` link.
4131
+ *
4132
+ * This interface was referenced by `Item`'s JSON-Schema
4133
+ * via the `bulk_move_to_stage.targetSchema` link.
4134
+ *
4135
+ * This interface was referenced by `ItemVersion`'s JSON-Schema
4136
+ * via the `restore.targetSchema` link.
4137
+ *
4138
+ * This interface was referenced by `Upload`'s JSON-Schema
4139
+ * via the `create.targetSchema` link.
4140
+ *
4141
+ * This interface was referenced by `Upload`'s JSON-Schema
4142
+ * via the `update.targetSchema` link.
4143
+ *
4144
+ * This interface was referenced by `Upload`'s JSON-Schema
4145
+ * via the `batch_add_tags.targetSchema` link.
4146
+ *
4147
+ * This interface was referenced by `Upload`'s JSON-Schema
4148
+ * via the `batch_destroy.targetSchema` link.
4149
+ *
4150
+ * This interface was referenced by `Upload`'s JSON-Schema
4151
+ * via the `bulk_tag.targetSchema` link.
4152
+ *
4153
+ * This interface was referenced by `Upload`'s JSON-Schema
4154
+ * via the `bulk_destroy.targetSchema` link.
4155
+ *
4156
+ * This interface was referenced by `Site`'s JSON-Schema
4157
+ * via the `update.targetSchema` link.
4158
+ *
4159
+ * This interface was referenced by `Site`'s JSON-Schema
4160
+ * via the `activate_improved_timezone_management.targetSchema` link.
4161
+ *
4162
+ * This interface was referenced by `DatoApi`'s JSON-Schema
4163
+ * via the `definition` "job".
4164
+ */
4165
+ export declare type Job = {
4166
+ id: JobIdentity;
4167
+ type: JobType;
4168
+ };
4169
+ export declare type ItemTypeUpdateTargetSchema = Job;
4170
+ export declare type ItemTypeDestroyTargetSchema = Job;
4171
+ export declare type FieldCreateTargetSchema = Job;
4172
+ export declare type FieldUpdateTargetSchema = Job;
4173
+ export declare type FieldDestroyTargetSchema = Job;
4174
+ export declare type FieldDuplicateTargetSchema = Job;
4175
+ export declare type ItemDuplicateTargetSchema = Job;
4176
+ export declare type ItemDestroyTargetSchema = Job;
4177
+ export declare type ItemBatchDestroyTargetSchema = Job;
4178
+ export declare type ItemBatchPublishTargetSchema = Job;
4179
+ export declare type ItemBatchUnpublishTargetSchema = Job;
4180
+ export declare type ItemBulkPublishTargetSchema = Job;
4181
+ export declare type ItemBulkUnpublishTargetSchema = Job;
4182
+ export declare type ItemBulkDestroyTargetSchema = Job;
4183
+ export declare type ItemBulkMoveToStageTargetSchema = Job;
4184
+ export declare type ItemVersionRestoreTargetSchema = Job;
4185
+ export declare type UploadCreateTargetSchema = Job;
4186
+ export declare type UploadUpdateTargetSchema = Job;
4187
+ export declare type UploadBatchAddTagsTargetSchema = Job;
4188
+ export declare type UploadBatchDestroyTargetSchema = Job;
4189
+ export declare type UploadBulkTagTargetSchema = Job;
4190
+ export declare type UploadBulkDestroyTargetSchema = Job;
4191
+ export declare type SiteUpdateTargetSchema = Job;
4192
+ export declare type SiteActivateImprovedTimezoneManagementTargetSchema = Job;
4193
+ /**
4194
+ * JSON API data
4195
+ *
4196
+ * This interface was referenced by `Job`'s JSON-Schema
4197
+ * via the `definition` "data".
4198
+ */
4199
+ export declare type JobData = {
4200
+ type: JobType;
4201
+ id: JobIdentity;
4202
+ };
4203
+ /**
4204
+ * DatoCMS offers a number of different fields that you can combine togheter to create a [Model](/docs/content-management-api/resources/item-type). Using the database metaphore, fields are like table columns, and when creating them you need to specify their type (`string`, `float`, etc.) and any required validation.
4205
+ *
4206
+ * ### Different field types require different settings
4207
+ *
4208
+ * When looking at a field resource, you have to pay attention to two particular properties, `validators` and `appearance`.
4209
+ *
4210
+ * The `validators` property expresses the set of validations to be performed server-side on a specific field value for it to be considered valid, while the `appearance` property lets you specify _how_ the field itself will be presented inside the form to the final editor.
4211
+ *
4212
+ * For both properties, the value to specify depends on the type of field itself. For example, you can add a "Limit character count" validation to a _Single-line string_ field, or set its appearence to "Show it as heading", but they won't be accepted for a ie. _Color_ field, as it supports different validations and appearance settings.
4213
+ *
4214
+ * ### Specifying validations
4215
+ *
4216
+ * The `validators` property requires an object whose keys are the validations that you want to be enforced, and the values are objects representing any settings that the validation itself requires. If the validation doesn't have additional settings, you just pass down an empty object.
4217
+ *
4218
+ * This is a valid example for a _Single-line string_ field:
4219
+ *
4220
+ * ```js
4221
+ * {
4222
+ * "validators": {
4223
+ * // "required" validator has no settings
4224
+ * "required": {},
4225
+ * // "length" validator requires "min" and/or "max" properties
4226
+ * "length": { "min": 80 }
4227
+ * }
4228
+ * }
4229
+ * ```
4230
+ *
4231
+ * Below you'll find a summary of all the validators available for each field type with their settings.
4232
+ *
4233
+ * Some validators are required for a specific type of field. For example, the _Slug_ field needs to have a `slug_title_field` validator to specify the ID of the _Single-line string_ field that will be used to generate the slug itself.
4234
+ *
4235
+ * ### Specifying the appearance
4236
+ *
4237
+ * The `appearance` property requires an object with three specific properties: `editor`, `parameters` and `addons`.
4238
+ *
4239
+ * The `editor` represents the type of editor that the users will see inside the form to change the value of this specific field. Depending on the type of field, DatoCMS offers a number of different editors for you to choose from. The `parameters` property is an object representing any additional settings that the editor itself might require.
4240
+ *
4241
+ * This is a valid example for a _Single-line string_ field:
4242
+ *
4243
+ * ```js
4244
+ * {
4245
+ * "appearance": {
4246
+ * // single_line is a DatoCMS built-in editor that you can use with single-line string fields
4247
+ * "editor": "single_line",
4248
+ * // each built-in editor has specific settings
4249
+ * "parameters": { "heading": true },
4250
+ * "addons": []
4251
+ * },
4252
+ * }
4253
+ * ```
4254
+ *
4255
+ * Following you'll find a summary of all the editors available for each field type with their settings.
4256
+ *
4257
+ * #### Setting the appearance to a field editor provided by a plugin
4258
+ *
4259
+ * If the project contains a plugin that exposes [manual field editors](/docs/plugin-sdk/manual-field-extensions), you can also configure the field to be presented with it instead of using one of the build-in editors.
4260
+ *
4261
+ * In this case:
4262
+ *
4263
+ * - the `editor` property must be the ID of the plugin;
4264
+ * - the `field_extension` property must be the ID of the specific manual field editor that the plugin exposes;
4265
+ * - the `parameters` property must provide a configuration object compatible with the [config screen of the manual field extension](/docs/plugin-sdk/manual-field-extensions#add-per-field-config-screens-to-manual-field-extensions), or an empty object if it doesn't require any configuration.
4266
+ *
4267
+ * ```js
4268
+ * {
4269
+ * "appearance": {
4270
+ * // "2132" is a the ID of a plugin exposing a manual field editor
4271
+ * "editor": "2134",
4272
+ * // "starRating" is a manual field editor exposed by the plugin
4273
+ * "field_extension": "starRating",
4274
+ * // this is a valid configuration for the "starRating" field editor
4275
+ * "parameters": { "maxRating": 5, "starsColor": "#ff0000" },
4276
+ * "addons": []
4277
+ * },
4278
+ * }
4279
+ * ```
4280
+ *
4281
+ * #### Configuring manual field addons
4282
+ *
4283
+ * If the project contains plugins that expose [manual field addons](/docs/plugin-sdk/manual-field-extensions), you can also add them to the field via the `addons` property.
4284
+ *
4285
+ * ```js
4286
+ * {
4287
+ * "appearance": {
4288
+ * "editor": "single_line",
4289
+ * "parameters": { "heading": true },
4290
+ * "addons": [
4291
+ * {
4292
+ * // "2138" is a the ID of a plugin exposing a manual addon editor
4293
+ * "id": "2138",
4294
+ * // "loremIpsumGenerator" is a manual field addon exposed by the plugin
4295
+ * "field_extension": "loremIpsumGenerator",
4296
+ * // this is a valid configuration for the "loremIpsumGenerator" field addon
4297
+ * "parameters": { "sentences": 2 },
4298
+ * }
4299
+ * ]
4300
+ * },
4301
+ * }
4302
+ * ```
4303
+ *
4304
+ * ### Available field types
4305
+ *
4306
+ * <details>
4307
+ * <summary>Single-line string (<code>string</code>)</summary>
4308
+ *
4309
+ * | Property | Value |
4310
+ * | ------------------------------ | ---------------------------------------------------- |
4311
+ * | Code | `string` |
4312
+ * | Built-in editors for the field | `single_line`, `string_radio_group`, `string_select` |
4313
+ * | Available validators | `required`, `unique`, `length`, `format`, `enum` |
4314
+ *
4315
+ * </details>
4316
+ *
4317
+ * <details>
4318
+ * <summary>Multi-line text (<code>text</code>)</summary>
4319
+ *
4320
+ * | Property | Value |
4321
+ * | ------------------------------ | --------------------------------- |
4322
+ * | Code | `text` |
4323
+ * | Built-in editors for the field | `markdown`, `wysiwyg`, `textarea` |
4324
+ * | Available validators | `required`, `length`, `format` |
4325
+ *
4326
+ * </details>
4327
+ *
4328
+ * <details>
4329
+ * <summary>Boolean (<code>boolean</code>)</summary>
4330
+ *
4331
+ * | Property | Value |
4332
+ * | ------------------------------ | -------------------------------- |
4333
+ * | Code | `boolean` |
4334
+ * | Built-in editors for the field | `boolean`, `boolean_radio_group` |
4335
+ * | Available validators | no validators available |
4336
+ *
4337
+ * </details>
4338
+ *
4339
+ * <details>
4340
+ * <summary>Integer (<code>integer</code>)</summary>
4341
+ *
4342
+ * | Property | Value |
4343
+ * | ------------------------------ | -------------------------- |
4344
+ * | Code | `integer` |
4345
+ * | Built-in editors for the field | `integer` |
4346
+ * | Available validators | `required`, `number_range` |
4347
+ *
4348
+ * </details>
4349
+ *
4350
+ * <details>
4351
+ * <summary>Float (<code>float</code>)</summary>
4352
+ *
4353
+ * | Property | Value |
4354
+ * | ------------------------------ | -------------------------- |
4355
+ * | Code | `float` |
4356
+ * | Built-in editors for the field | `float` |
4357
+ * | Available validators | `required`, `number_range` |
4358
+ *
4359
+ * </details>
4360
+ *
4361
+ * <details>
4362
+ * <summary>Date (<code>date</code>)</summary>
4363
+ *
4364
+ * | Property | Value |
4365
+ * | ------------------------------ | ------------------------ |
4366
+ * | Code | `date` |
4367
+ * | Built-in editors for the field | `date_picker` |
4368
+ * | Available validators | `required`, `date_range` |
4369
+ *
4370
+ * </details>
4371
+ *
4372
+ * <details>
4373
+ * <summary>Date time (<code>date_time</code>)</summary>
4374
+ *
4375
+ * | Property | Value |
4376
+ * | ------------------------------ | ----------------------------- |
4377
+ * | Code | `date_time` |
4378
+ * | Built-in editors for the field | `date_time_picker` |
4379
+ * | Available validators | `required`, `date_time_range` |
4380
+ *
4381
+ * </details>
4382
+ *
4383
+ * <details>
4384
+ * <summary>Color (<code>color</code>)</summary>
4385
+ *
4386
+ * | Property | Value |
4387
+ * | ------------------------------ | -------------- |
4388
+ * | Code | `color` |
4389
+ * | Built-in editors for the field | `color_picker` |
4390
+ * | Available validators | `required` |
4391
+ *
4392
+ * </details>
4393
+ *
4394
+ * <details>
4395
+ * <summary>JSON (<code>json</code>)</summary>
4396
+ *
4397
+ * | Property | Value |
4398
+ * | ------------------------------ | ------------------------------------------------------ |
4399
+ * | Code | `json` |
4400
+ * | Built-in editors for the field | `json`, `string_multi_select`, `string_checkbox_group` |
4401
+ * | Available validators | `required` |
4402
+ *
4403
+ * </details>
4404
+ *
4405
+ * <details>
4406
+ * <summary>Location (<code>lat_lon</code>)</summary>
4407
+ *
4408
+ * | Property | Value |
4409
+ * | ------------------------------ | ---------- |
4410
+ * | Code | `lat_lon` |
4411
+ * | Built-in editors for the field | `map` |
4412
+ * | Available validators | `required` |
4413
+ *
4414
+ * </details>
4415
+ *
4416
+ * <details>
4417
+ * <summary>SEO (<code>seo</code>)</summary>
4418
+ *
4419
+ * | Property | Value |
4420
+ * | ------------------------------ | -------------------------------------------------------------------------------------------- |
4421
+ * | Code | `seo` |
4422
+ * | Built-in editors for the field | `seo` |
4423
+ * | Available validators | `required_seo_fields`, `file_size`, `image_dimensions`, `title_length`, `description_length` |
4424
+ *
4425
+ * </details>
4426
+ *
4427
+ * <details>
4428
+ * <summary>Slug (<code>slug</code>)</summary>
4429
+ *
4430
+ * | Property | Value |
4431
+ * | ------------------------------ | ----------------------------------- |
4432
+ * | Code | `slug` |
4433
+ * | Built-in editors for the field | `slug` |
4434
+ * | Required validators | `slug_title_field` |
4435
+ * | Other validators available | `required`, `length`, `slug_format` |
4436
+ *
4437
+ * </details>
4438
+ *
4439
+ * <details>
4440
+ * <summary>External video (<code>video</code>)</summary>
4441
+ *
4442
+ * | Property | Value |
4443
+ * | ------------------------------ | ---------- |
4444
+ * | Code | `video` |
4445
+ * | Built-in editors for the field | `video` |
4446
+ * | Available validators | `required` |
4447
+ *
4448
+ * </details>
4449
+ *
4450
+ * <details>
4451
+ * <summary>Single-asset (<code>file</code>)</summary>
4452
+ *
4453
+ * | Property | Value |
4454
+ * | ------------------------------ | ------------------------------------------------------------------------------ |
4455
+ * | Code | `file` |
4456
+ * | Built-in editors for the field | `file` |
4457
+ * | Available validators | `required`, `file_size`, `image_dimensions`, `extension`, `required_alt_title` |
4458
+ *
4459
+ * </details>
4460
+ *
4461
+ * <details>
4462
+ * <summary>Asset gallery (<code>gallery</code>)</summary>
4463
+ *
4464
+ * | Property | Value |
4465
+ * | ------------------------------ | -------------------------------------------------------------------------- |
4466
+ * | Code | `gallery` |
4467
+ * | Built-in editors for the field | `gallery` |
4468
+ * | Available validators | `size`, `file_size`, `image_dimensions`, `extension`, `required_alt_title` |
4469
+ *
4470
+ * </details>
4471
+ *
4472
+ * <details>
4473
+ * <summary>Single link (<code>link</code>)</summary>
4474
+ *
4475
+ * | Property | Value |
4476
+ * | ------------------------------ | --------------------------- |
4477
+ * | Code | `link` |
4478
+ * | Built-in editors for the field | `link_select`, `link_embed` |
4479
+ * | Default `editor` | `link_select` |
4480
+ * | Required validators | `item_item_type` |
4481
+ * | Other validators available | `required`, `unique` |
4482
+ *
4483
+ * </details>
4484
+ *
4485
+ * <details>
4486
+ * <summary>Multiple links (<code>links</code>)</summary>
4487
+ *
4488
+ * | Property | Value |
4489
+ * | ------------------------------ | ----------------------------- |
4490
+ * | Code | `links` |
4491
+ * | Built-in editors for the field | `links_select`, `links_embed` |
4492
+ * | Default `editor` | `links_select` |
4493
+ * | Required validators | `items_item_type` |
4494
+ * | Other validators available | `size` |
4495
+ *
4496
+ * </details>
4497
+ *
4498
+ * <details>
4499
+ * <summary>Modular content (<code>rich_text</code>)</summary>
4500
+ *
4501
+ * | Property | Value |
4502
+ * | ------------------------------ | ------------------ |
4503
+ * | Code | `rich_text` |
4504
+ * | Built-in editors for the field | `rich_text` |
4505
+ * | Required validators | `rich_text_blocks` |
4506
+ * | Other validators available | `size` |
4507
+ *
4508
+ * </details>
4509
+ *
4510
+ * <details>
4511
+ * <summary>Structured text (<code>structured_text</code>)</summary>
4512
+ *
4513
+ * | Property | Value |
4514
+ * | ------------------------------ | ------------------------------------------------- |
4515
+ * | Code | `structured_text` |
4516
+ * | Built-in editors for the field | `structured_text` |
4517
+ * | Required validators | `structured_text_blocks`, `structured_text_links` |
4518
+ * | Other validators available | `length` |
4519
+ *
4520
+ * </details>
4521
+ *
4522
+ * ### Validators
4523
+ *
4524
+ * <details>
4525
+ * <summary><code>date_range</code></summary>
4526
+ *
4527
+ * Accept dates only inside a specified date range.
4528
+ *
4529
+ * | Parameter | Type | Required | Description |
4530
+ * | --------- | ------------- | -------- | ------------ |
4531
+ * | `min` | ISO 8601 date | | Minimum date |
4532
+ * | `max` | ISO 8601 date | | Maximum date |
4533
+ *
4534
+ * At least one of the parameters must be specified.
4535
+ *
4536
+ * </details>
4537
+ *
4538
+ * <details>
4539
+ * <summary><code>date_time_range</code></summary>
4540
+ *
4541
+ * Accept date times only inside a specified date range.
4542
+ *
4543
+ * | Parameter | Type | Required | Description |
4544
+ * | --------- | ----------------- | -------- | ---------------- |
4545
+ * | `min` | ISO 8601 datetime | | Minimum datetime |
4546
+ * | `max` | ISO 8601 datetime | | Maximum datetime |
4547
+ *
4548
+ * At least one of the parameters must be specified.
4549
+ *
4550
+ * </details>
4551
+ *
4552
+ * <details>
4553
+ * <summary><code>enum</code></summary>
4554
+ *
4555
+ * Only accept a specific set of values
4556
+ *
4557
+ * | Parameter | Type | Required | Description |
4558
+ * | --------- | --------------- | -------- | --------------------- |
4559
+ * | `values` | `Array<String>` | ✅ | Set of allowed values |
4560
+ *
4561
+ * </details>
4562
+ *
4563
+ * <details>
4564
+ * <summary><code>extension</code></summary>
4565
+ *
4566
+ * Only accept assets with specific file extensions.
4567
+ *
4568
+ * | Parameter | Type | Required | Description |
4569
+ * | ----------------- | ----------------------------------------- | -------- | ------------------------------ |
4570
+ * | `extensions` | `Array<String>` | | Set of allowed file extensions |
4571
+ * | `predefined_list` | one of `"image"`, `"transformable_image"`, `"video"`, `"document"` | | Allowed file type |
4572
+ *
4573
+ * Only one of the parameters must be specified.
4574
+ *
4575
+ * </details>
4576
+ *
4577
+ * <details>
4578
+ * <summary><code>file_size</code></summary>
4579
+ *
4580
+ * Accept assets only inside a specified date range.
4581
+ *
4582
+ * | Parameter | Type | Required | Description |
4583
+ * | ----------- | ---------------------------- | -------- | ---------------------------------- |
4584
+ * | `min_value` | `Integer` | | Numeric value for minimum filesize |
4585
+ * | `min_unit` | one of `"B"`, `"KB"`, `"MB"` | | Unit for minimum filesize |
4586
+ * | `max_value` | `Integer` | | Numeric value for maximum filesize |
4587
+ * | `max_unit` | one of `"B"`, `"KB"`, `"MB"` | | Unit for maximum filesize |
4588
+ *
4589
+ * At least one couple of value/unit must be specified.
4590
+ *
4591
+ * </details>
4592
+ *
4593
+ * <details>
4594
+ * <summary><code>format</code></summary>
4595
+ *
4596
+ * Only accept strings having a specific format.
4597
+ *
4598
+ * | Parameter | Type | Required | Description |
4599
+ * | -------------------- | ------------------------- | -------- | ---------------------------------- |
4600
+ * | `custom_pattern` | `Regexp` | | Regular expression to be validated |
4601
+ * | `predefined_pattern` | one of `"email"`, `"url"` | | Allowed format |
4602
+ *
4603
+ * Only one of the parameters must be specified.
4604
+ *
4605
+ * </details>
4606
+ *
4607
+ * <details>
4608
+ * <summary><code>slug_format</code></summary>
4609
+ *
4610
+ * Only accept slugs having a specific format.
4611
+ *
4612
+ * | Parameter | Type | Required | Description |
4613
+ * | -------------------- | ---------------- | -------- | ---------------------------------- |
4614
+ * | `custom_pattern` | `Regexp` | | Regular expression to be validated |
4615
+ * | `predefined_pattern` | `"webpage_slug"` | | Allowed format |
4616
+ *
4617
+ * Only one of the parameters must be specified.
4618
+ *
4619
+ * </details>
4620
+ *
4621
+ * <details>
4622
+ * <summary><code>image_dimensions</code></summary>
4623
+ *
4624
+ * Accept assets only within a specified height/width range.
4625
+ *
4626
+ * | Parameter | Type | Required | Description |
4627
+ * | ------------------ | --------- | -------- | -------------------------------- |
4628
+ * | `width_min_value` | `Integer` | | Numeric value for minimum width |
4629
+ * | `width_max_value` | `Integer` | | Numeric value for maximum height |
4630
+ * | `height_min_value` | `Integer` | | Numeric value for minimum width |
4631
+ * | `height_max_value` | `Integer` | | Numeric value for maximum height |
4632
+ *
4633
+ * At least one parameter must be specified.
4634
+ *
4635
+ * </details>
4636
+ *
4637
+ * <details>
4638
+ * <summary><code>item_item_type</code></summary>
4639
+ *
4640
+ * Only accept references to records of the specified models.
4641
+ *
4642
+ * | Parameter | Type | Required | Description |
4643
+ * | ------------------------------------------------- | ------------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------- |
4644
+ * | `item_types` | `Array<Model ID>` | ✅ | Set of allowed model IDs |
4645
+ * | `on_publish_with_unpublished_references_strategy` | `"fail"`, `"publish_references"` (default value: `"fail"`) | | Strategy to apply when a publishing is requested and this field references some unpublished records |
4646
+ * | `on_reference_unpublish_strategy` | `"fail"`, `"unpublish"`, `"delete_references"` (default value: `"fail"`) | | Strategy to apply when unpublishing is requested for a record referenced by this field |
4647
+ * | `on_reference_delete_strategy` | `"fail"`, `"delete_references"` (default value: `"delete_references"`) | | Strategy to apply when deletion is requested for a record referenced by this field |
4648
+ *
4649
+ * Possible values for `on_publish_with_unpublished_references_strategy`:
4650
+ *
4651
+ * - `"fail"`: Fail the operation and notify the user
4652
+ * - `"publish_references"`: Publish also the referenced records
4653
+ *
4654
+ * Possible values for `on_reference_unpublish_strategy`:
4655
+ *
4656
+ * - `"fail"`: Fail the operation and notify the user
4657
+ * - `"unpublish"`: Unpublish also this record
4658
+ * - `"delete_references"`: Try to remove the reference to the unpublished record (if the field has a `required` validation it will fail)
4659
+ *
4660
+ * Possible values for `on_reference_delete_strategy`:
4661
+ *
4662
+ * - `"fail"`: Fail the operation and notify the user
4663
+ * - `"delete_references"`: Try to remove the reference to the deleted record (if the field has a `required` validation it will fail)
4664
+ * </details>
4665
+ *
4666
+ * <details>
4667
+ * <summary><code>items_item_type</code></summary>
4668
+ *
4669
+ * Only accept references to records of the specified models.
4670
+ *
4671
+ * | Parameter | Type | Required | Description |
4672
+ * | ------------------------------------------------- | ------------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------- |
4673
+ * | `item_types` | `Array<Model ID>` | ✅ | Set of allowed model IDs |
4674
+ * | `on_publish_with_unpublished_references_strategy` | `"fail"`, `"publish_references"` (default value: `"fail"`) | | Strategy to apply when a publishing is requested and this field references some unpublished records |
4675
+ * | `on_reference_unpublish_strategy` | `"fail"`, `"unpublish"`, `"delete_references"` (default value: `"fail"`) | | Strategy to apply when unpublishing is requested for a record referenced by this field |
4676
+ * | `on_reference_delete_strategy` | `"fail"`, `"delete_references"` (default value: `"delete_references"`) | | Strategy to apply when deletion is requested for a record referenced by this field |
4677
+ *
4678
+ * Possible values for `on_publish_with_unpublished_references_strategy`:
4679
+ *
4680
+ * - `"fail"`: Fail the operation and notify the user
4681
+ * - `"publish_references"`: Publish also the referenced records
4682
+ *
4683
+ * Possible values for `on_reference_unpublish_strategy`:
4684
+ *
4685
+ * - `"fail"`: Fail the operation and notify the user
4686
+ * - `"unpublish"`: Unpublish also this record
4687
+ * - `"delete_references"`: Try to remove the reference to the unpublished record (if the field has a `required` validation it will fail)
4688
+ *
4689
+ * Possible values for `on_reference_delete_strategy`:
4690
+ *
4691
+ * - `"fail"`: Fail the operation and notify the user
4692
+ * - `"delete_references"`: Try to remove the reference to the deleted record (if the field has a `required` validation it will fail)
4693
+ * </details>
4694
+ *
4695
+ * <details>
4696
+ * <summary><code>length</code></summary>
4697
+ *
4698
+ * Accept strings only with a specified number of characters.
4699
+ *
4700
+ * | Parameter | Type | Required | Description |
4701
+ * | --------- | --------- | -------- | --------------- |
4702
+ * | `min` | `Integer` | | Minimum length |
4703
+ * | `eq` | `Integer` | | Expected length |
4704
+ * | `max` | `Integer` | | Maximum length |
4705
+ *
4706
+ * At least one parameter must be specified.
4707
+ *
4708
+ * </details>
4709
+ *
4710
+ * <details>
4711
+ * <summary><code>number_range</code></summary>
4712
+ *
4713
+ * Accept numbers only inside a specified range.
4714
+ *
4715
+ * | Parameter | Type | Required | Description |
4716
+ * | --------- | ------- | -------- | ------------- |
4717
+ * | `min` | `Float` | | Minimum value |
4718
+ * | `max` | `Float` | | Maximum value |
4719
+ *
4720
+ * At least one of the parameters must be specified.
4721
+ *
4722
+ * </details>
4723
+ *
4724
+ * <details>
4725
+ * <summary><code>required</code></summary>
4726
+ *
4727
+ * Value must be specified or it won't be valid.
4728
+ *
4729
+ * </details>
4730
+ *
4731
+ * <details>
4732
+ * <summary><code>required_alt_title</code></summary>
4733
+ *
4734
+ * Assets contained in the field are required to specify custom title or alternate text, or they won't be valid.
4735
+ *
4736
+ * | Parameter | Type | Required | Description |
4737
+ * | --------- | --------- | -------- | ---------------------------------------------------------- |
4738
+ * | `title` | `Boolean` | | Whether the title for the asset must be specified |
4739
+ * | `alt` | `Boolean` | | Whether the alternate text for the asset must be specified |
4740
+ *
4741
+ * At least one of the parameters must be specified.
4742
+ *
4743
+ * </details>
4744
+ *
4745
+ * <details>
4746
+ * <summary><code>required_seo_fields</code></summary>
4747
+ *
4748
+ * SEO field is to specify one or more properties, or it won't be valid.
4749
+ *
4750
+ * | Parameter | Type | Required | Description |
4751
+ * | -------------- | --------- | -------- | -------------------------------------------------- |
4752
+ * | `title` | `Boolean` | | Whether the meta title must be specified |
4753
+ * | `description` | `Boolean` | | Whether the meta description must be specified |
4754
+ * | `image` | `Boolean` | | Whether the social sharing image must be specified |
4755
+ * | `twitter_card` | `Boolean` | | Whether the type of Twitter card must be specified |
4756
+ *
4757
+ * At least one of the parameters must be specified.
4758
+ *
4759
+ * </details>
4760
+ *
4761
+ * <details>
4762
+ * <summary><code>title_length</code></summary>
4763
+ *
4764
+ * Limits the length of the title for a SEO field. Search engines usually truncate title tags to 60 character so it is a good practice to keep the title around this length.
4765
+ *
4766
+ * | Parameter | Type | Required | Description |
4767
+ * | --------- | --------- | -------- | ------------- |
4768
+ * | `min` | `Integer` | | Minimum value |
4769
+ * | `max` | `Integer` | | Maximum value |
4770
+ *
4771
+ * At least one of the parameters must be specified.
4772
+ *
4773
+ * </details>
4774
+ *
4775
+ * <details>
4776
+ * <summary><code>description_length</code></summary>
4777
+ *
4778
+ * Limits the length of the description for a SEO field. Search engines usually truncate description tags to 160 character so it is a good practice to keep the description around this length.
4779
+ *
4780
+ * | Parameter | Type | Required | Description |
4781
+ * | --------- | --------- | -------- | ------------- |
4782
+ * | `min` | `Integer` | | Minimum value |
4783
+ * | `max` | `Integer` | | Maximum value |
4784
+ *
4785
+ * At least one of the parameters must be specified.
4786
+ *
4787
+ * </details>
4788
+ *
4789
+ * <details>
4790
+ * <summary><code>rich_text_blocks</code></summary>
4791
+ *
4792
+ * Only accept references to block records of the specified block models.
4793
+ *
4794
+ * | Parameter | Type | Required | Description |
4795
+ * | ------------ | ----------------------- | -------- | ------------------------------ |
4796
+ * | `item_types` | `Array<Block Model ID>` | ✅ | Set of allowed Block Model IDs |
4797
+ *
4798
+ * </details>
4799
+ *
4800
+ * <details>
4801
+ * <summary><code>structured_text_blocks</code></summary>
4802
+ *
4803
+ * Only accept references to block records of the specified block models.
4804
+ *
4805
+ * | Parameter | Type | Required | Description |
4806
+ * | ------------ | ----------------------- | -------- | ------------------------------ |
4807
+ * | `item_types` | `Array<Block Model ID>` | ✅ | Set of allowed Block Model IDs |
4808
+ *
4809
+ * </details>
4810
+ *
4811
+ * <details>
4812
+ * <summary><code>structured_text_links</code></summary>
4813
+ *
4814
+ * Only accept `itemLink` to `inlineItem` nodes for records of the specified models.
4815
+ *
4816
+ * | Parameter | Type | Required | Description |
4817
+ * | ------------------------------------------------- | ------------------------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------- |
4818
+ * | `item_types` | `Array<Model ID>` | ✅ | Set of allowed model IDs |
4819
+ * | `on_publish_with_unpublished_references_strategy` | `"fail"`, `"publish_references"` (default value: `"fail"`) | | Strategy to apply when a publishing is requested and this field references some unpublished records |
4820
+ * | `on_reference_unpublish_strategy` | `"fail"`, `"unpublish"`, `"delete_references"` (default value: `"delete_references"`) | | Strategy to apply when unpublishing is requested for a record referenced by this field |
4821
+ * | `on_reference_delete_strategy` | `"fail"`, `"delete_references"` (default value: `"delete_references"`) | | Strategy to apply when deletion is requested for a record referenced by this field |
4822
+ *
4823
+ * Possible values for `on_publish_with_unpublished_references_strategy`:
4824
+ *
4825
+ * - `"fail"`: Fail the operation and notify the user
4826
+ * - `"publish_references"`: Publish also the referenced records
4827
+ *
4828
+ * Possible values for `on_reference_unpublish_strategy`:
4829
+ *
4830
+ * - `"fail"`: Fail the operation and notify the user
4831
+ * - `"unpublish"`: Unpublish also this record
4832
+ * - `"delete_references"`: Try to remove the reference to the unpublished record (if the field has a `required` validation it will fail)
4833
+ *
4834
+ * Possible values for `on_reference_delete_strategy`:
4835
+ *
4836
+ * - `"fail"`: Fail the operation and notify the user
4837
+ * - `"delete_references"`: Try to remove the reference to the deleted record (if the field has a `required` validation it will fail)
4838
+ * </details>
4839
+ *
4840
+ * <details>
4841
+ * <summary><code>size</code></summary>
4842
+ *
4843
+ * Only accept a number of items within the specified range.
4844
+ *
4845
+ * | Parameter | Type | Required | Description |
4846
+ * | ------------- | --------- | -------- | -------------------------------------------------- |
4847
+ * | `min` | `Integer` | | Minimum length |
4848
+ * | `eq` | `Integer` | | Expected length |
4849
+ * | `max` | `Integer` | | Maximum length |
4850
+ * | `multiple_of` | `Integer` | | The number of items must be multiple of this value |
4851
+ *
4852
+ * At least one parameter must be specified.
4853
+ *
4854
+ * </details>
4855
+ *
4856
+ * <details>
4857
+ * <summary><code>slug_title_field</code></summary>
4858
+ *
4859
+ * Specifies the ID of the _Single-line string_ field that will be used to generate the slug
4860
+ *
4861
+ * | Parameter | Type | Required | Description |
4862
+ * | ---------------- | ---------- | -------- | ------------------------------------------------ |
4863
+ * | `title_field_id` | `Field ID` | ✅ | The field that will be used to generate the slug |
4864
+ *
4865
+ * </details>
4866
+ *
4867
+ * <details>
4868
+ * <summary><code>unique</code></summary>
4869
+ *
4870
+ * The value must be unique across the whole collection of records.
4871
+ *
4872
+ * </details>
4873
+ *
4874
+ * ### Configuration parameters for DatoCMS built-in field editors
4875
+ *
4876
+ * If a field editor is not specified in this table, just pass an empty object `{}` as its configuration parameters.
4877
+ *
4878
+ * <details>
4879
+ * <summary><code>boolean_radio_group</code></summary>
4880
+ *
4881
+ * Radio group input for _boolean_ fields.
4882
+ *
4883
+ * | Parameter | Type | Required | Description |
4884
+ * | ---------------- | ---------------------------------- | -------- | ----------------------------------------- |
4885
+ * | `positive_radio` | `{ label: string, hint?: string }` | ✅ | Radio input for positive choice (`true`) |
4886
+ * | `negative_radio` | `{ label: string, hint?: string }` | ✅ | Radio input for negative choice (`false`) |
4887
+ *
4888
+ * </details>
4889
+ *
4890
+ * <details>
4891
+ * <summary><code>string_radio_group</code></summary>
4892
+ *
4893
+ * Radio group input for _string_ fields.
4894
+ *
4895
+ * | Parameter | Type | Required | Description |
4896
+ * | --------- | -------------------------------------------------------- | -------- | --------------------------- |
4897
+ * | `radios` | `Array<{ label: string, value: string, hint?: string }>` | ✅ | The different radio options |
4898
+ *
4899
+ * </details>
4900
+ *
4901
+ * <details>
4902
+ * <summary><code>string_select</code></summary>
4903
+ *
4904
+ * Select input for _string_ fields.
4905
+ *
4906
+ * | Parameter | Type | Required | Description |
4907
+ * | --------- | -------------------------------------------------------- | -------- | ---------------------------- |
4908
+ * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅ | The different select options |
4909
+ *
4910
+ * </details>
4911
+ *
4912
+ * <details>
4913
+ * <summary><code>string_multi_select</code></summary>
4914
+ *
4915
+ * Select input for _JSON_ fields, to edit an array of strings.
4916
+ *
4917
+ * | Parameter | Type | Required | Description |
4918
+ * | --------- | -------------------------------------------------------- | -------- | ---------------------------- |
4919
+ * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅ | The different select options |
4920
+ *
4921
+ * </details>
4922
+ *
4923
+ * <details>
4924
+ * <summary><code>string_checkbox_group</code></summary>
4925
+ *
4926
+ * Multiple chechboxes input for _JSON_ fields, to edit an array of strings.
4927
+ *
4928
+ * | Parameter | Type | Required | Description |
4929
+ * | --------- | -------------------------------------------------------- | -------- | ---------------------------- |
4930
+ * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅ | The different select options |
4931
+ *
4932
+ * </details>
4933
+ *
4934
+ * <details>
4935
+ * <summary><code>single_line</code></summary>
4936
+ *
4937
+ * Simple textual input for _Single-line string_ fields.
4938
+ *
4939
+ * | Parameter | Type | Required | Description |
4940
+ * | --------- | --------- | -------- | -------------------------------------------------------------------------------- |
4941
+ * | `heading` | `Boolean` | ✅ | Indicates if the field should be shown bigger, as a field representing a heading |
4942
+ *
4943
+ * </details>
4944
+ *
4945
+ * <details>
4946
+ * <summary><code>markdown</code></summary>
4947
+ *
4948
+ * Markdown editor for _Multiple-paragraph text_ fields.
4949
+ *
4950
+ * | Parameter | Type | Required | Description |
4951
+ * | --------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
4952
+ * | `toolbar` | `Array<String>` | ✅ | Specify which buttons the toolbar should have. Valid values: `"heading"`, `"bold"`, `"italic"`, `"strikethrough"`, `"code"`, `"unordered_list"`, `"ordered_list"`, `"quote"`, `"link"`, `"image"`, `"fullscreen"` |
4953
+ *
4954
+ * </details>
4955
+ *
4956
+ * <details>
4957
+ * <summary><code>wysiwyg</code></summary>
4958
+ *
4959
+ * HTML editor for _Multiple-paragraph text_ fields.
4960
+ *
4961
+ * | Parameter | Type | Required | Description |
4962
+ * | --------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
4963
+ * | `toolbar` | `Array<String>` | ✅ | Specify which buttons the toolbar should have. Valid values: `"format"`, `"bold"`, `"italic"`, `"strikethrough"`, `"code"`, `"ordered_list"`, `"unordered_list"`, `"quote"`, `"table"`, `"link"`, `"image"`, `"show_source"`, `"undo"`, `"redo"`, `"align_left"`, `"align_center"`, `"align_right"`, `"align_justify"`, `"outdent"`, `"indent"`, `"fullscreen"` |
4964
+ *
4965
+ * </details>
4966
+ *
4967
+ * <details>
4968
+ * <summary><code>textarea</code></summary>
4969
+ *
4970
+ * Basic textarea editor for _Multiple-paragraph text_ fields.
4971
+ *
4972
+ * </details>
4973
+ *
4974
+ * <details>
4975
+ * <summary><code>color_picker</code></summary>
4976
+ *
4977
+ * Built-in editor for _Color_ fields.
4978
+ *
4979
+ * | Parameter | Type | Required | Description |
4980
+ * | --------------- | ------------------------- | -------- | --------------------------------------------------------- |
4981
+ * | `enable_alpha` | `Boolean` | ✅ | Should the color picker allow to specify the alpha value? |
4982
+ * | `preset_colors` | `Array<Hex color string>` | ✅ | List of preset colors to offer to the user |
4983
+ *
4984
+ * </details>
4985
+ *
4986
+ * <details>
4987
+ * <summary><code>slug</code></summary>
4988
+ *
4989
+ * Built-in editor for _Slug_ fields.
3924
4990
  *
3925
- * This interface was referenced by `Item`'s JSON-Schema
3926
- * via the `batch_publish.targetSchema` link.
4991
+ * | Parameter | Type | Required | Description |
4992
+ * | ------------ | -------- | -------- | -------------------------------------------------------------------------------------- |
4993
+ * | `url_prefix` | `String` | | A prefix that will be shown in the editor's form to give some context to your editors. |
3927
4994
  *
3928
- * This interface was referenced by `Item`'s JSON-Schema
3929
- * via the `batch_unpublish.targetSchema` link.
4995
+ * </details>
3930
4996
  *
3931
- * This interface was referenced by `Item`'s JSON-Schema
3932
- * via the `bulk_publish.targetSchema` link.
4997
+ * <details>
4998
+ * <summary><code>rich_text</code></summary>
3933
4999
  *
3934
- * This interface was referenced by `Item`'s JSON-Schema
3935
- * via the `bulk_unpublish.targetSchema` link.
5000
+ * Built-in editor for _Modular content_ fields.
3936
5001
  *
3937
- * This interface was referenced by `Item`'s JSON-Schema
3938
- * via the `bulk_destroy.targetSchema` link.
5002
+ * | Parameter | Type | Required | Description |
5003
+ * | ----------------- | --------- | -------- | ---------------------------------------------------------- |
5004
+ * | `start_collapsed` | `Boolean` | | Whether you want block records collapsed by default or not |
3939
5005
  *
3940
- * This interface was referenced by `Item`'s JSON-Schema
3941
- * via the `bulk_move_to_stage.targetSchema` link.
5006
+ * </details>
3942
5007
  *
3943
- * This interface was referenced by `ItemVersion`'s JSON-Schema
3944
- * via the `restore.targetSchema` link.
5008
+ * <details>
5009
+ * <summary><code>structured_text</code></summary>
3945
5010
  *
3946
- * This interface was referenced by `Upload`'s JSON-Schema
3947
- * via the `create.targetSchema` link.
5011
+ * Built-in editor for _Structured text_ fields.
3948
5012
  *
3949
- * This interface was referenced by `Upload`'s JSON-Schema
3950
- * via the `update.targetSchema` link.
5013
+ * | Parameter | Type | Required | Description |
5014
+ * | ------------------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
5015
+ * | `nodes` | `Array<String>` | ✅ | Specify which nodes the field should allow. Valid values: `"blockquote"`, `"code"`, `"heading"`, `"link"`, `"list"`, `"thematicBreak"` |
5016
+ * | `marks` | `Array<String>` | ✅ | Specify which marks the field should allow. Valid values: `"strong"`, `"emphasis"`, `"underline"`, `"strikethrough"`, `"code"`, `"highlight"` |
5017
+ * | `blocks_start_collapsed` | `Boolean` | | Whether you want block nodes collapsed by default or not |
5018
+ * | `show_links_target_blank` | `Boolean` | | Whether you want to show the "Open this link in a new tab?" checkbox, that fills in the `target: "_blank"` meta attribute for links |
5019
+ * | `show_links_meta_editor` | `Boolean` | | Whether you want to show the complete meta editor for links |
3951
5020
  *
3952
- * This interface was referenced by `Upload`'s JSON-Schema
3953
- * via the `batch_add_tags.targetSchema` link.
5021
+ * </details>
3954
5022
  *
3955
- * This interface was referenced by `Upload`'s JSON-Schema
3956
- * via the `batch_destroy.targetSchema` link.
5023
+ * <details>
5024
+ * <summary><code>link_select</code> and <code>links_select</code></summary>
3957
5025
  *
3958
- * This interface was referenced by `Upload`'s JSON-Schema
3959
- * via the `bulk_tag.targetSchema` link.
5026
+ * Use a select input with auto-completion to pick the records to reference inside the field.
3960
5027
  *
3961
- * This interface was referenced by `Upload`'s JSON-Schema
3962
- * via the `bulk_destroy.targetSchema` link.
5028
+ * </details>
3963
5029
  *
3964
- * This interface was referenced by `Site`'s JSON-Schema
3965
- * via the `update.targetSchema` link.
5030
+ * <details>
5031
+ * <summary><code>link_embed</code> and <code>links_embed</code></summary>
3966
5032
  *
3967
- * This interface was referenced by `DatoApi`'s JSON-Schema
3968
- * via the `definition` "job".
3969
- */
3970
- export declare type Job = {
3971
- id: JobIdentity;
3972
- type: JobType;
3973
- };
3974
- export declare type ItemTypeUpdateTargetSchema = Job;
3975
- export declare type ItemTypeDestroyTargetSchema = Job;
3976
- export declare type FieldCreateTargetSchema = Job;
3977
- export declare type FieldUpdateTargetSchema = Job;
3978
- export declare type FieldDestroyTargetSchema = Job;
3979
- export declare type FieldDuplicateTargetSchema = Job;
3980
- export declare type ItemDuplicateTargetSchema = Job;
3981
- export declare type ItemDestroyTargetSchema = Job;
3982
- export declare type ItemBatchDestroyTargetSchema = Job;
3983
- export declare type ItemBatchPublishTargetSchema = Job;
3984
- export declare type ItemBatchUnpublishTargetSchema = Job;
3985
- export declare type ItemBulkPublishTargetSchema = Job;
3986
- export declare type ItemBulkUnpublishTargetSchema = Job;
3987
- export declare type ItemBulkDestroyTargetSchema = Job;
3988
- export declare type ItemBulkMoveToStageTargetSchema = Job;
3989
- export declare type ItemVersionRestoreTargetSchema = Job;
3990
- export declare type UploadCreateTargetSchema = Job;
3991
- export declare type UploadUpdateTargetSchema = Job;
3992
- export declare type UploadBatchAddTagsTargetSchema = Job;
3993
- export declare type UploadBatchDestroyTargetSchema = Job;
3994
- export declare type UploadBulkTagTargetSchema = Job;
3995
- export declare type UploadBulkDestroyTargetSchema = Job;
3996
- export declare type SiteUpdateTargetSchema = Job;
3997
- /**
3998
- * JSON API data
5033
+ * Use an expanded view with records' image preview to pick the records to reference inside the field.
5034
+ *
5035
+ * </details>
3999
5036
  *
4000
- * This interface was referenced by `Job`'s JSON-Schema
4001
- * via the `definition` "data".
4002
- */
4003
- export declare type JobData = {
4004
- type: JobType;
4005
- id: JobIdentity;
4006
- };
4007
- /**
4008
- * Each Model consists of a set of fields. Using the database metaphore, fields are like table columns, and when creating them you need to specify their type (`string`, `file`, `float`, etc.) and any required validation.
4009
5037
  *
4010
5038
  * This interface was referenced by `DatoApi`'s JSON-Schema
4011
5039
  * via the `definition` "field".
@@ -4104,16 +5132,6 @@ export declare type FieldUpdateJobSchema = Field;
4104
5132
  export declare type FieldSelfTargetSchema = Field;
4105
5133
  export declare type FieldDestroyJobSchema = Field;
4106
5134
  export declare type FieldDuplicateJobSchema = Field;
4107
- /**
4108
- * JSON API data
4109
- *
4110
- * This interface was referenced by `Fieldset`'s JSON-Schema
4111
- * via the `definition` "data".
4112
- */
4113
- export declare type FieldsetData = {
4114
- type: FieldsetType;
4115
- id: FieldsetIdentity;
4116
- };
4117
5135
  /**
4118
5136
  * JSON API attributes
4119
5137
  *
@@ -4578,140 +5596,6 @@ export declare type SessionCreateSchema = {
4578
5596
  */
4579
5597
  otp_code?: string;
4580
5598
  };
4581
- /**
4582
- * An API token allows access to our API. It is linked to a Role, which describes what actions can be performed.
4583
- *
4584
- * This interface was referenced by `DatoApi`'s JSON-Schema
4585
- * via the `definition` "access_token".
4586
- */
4587
- export declare type AccessToken = {
4588
- id: AccessTokenIdentity;
4589
- type: AccessTokenType;
4590
- /**
4591
- * Name of API token
4592
- */
4593
- name: string;
4594
- /**
4595
- * The actual API token
4596
- */
4597
- token?: string;
4598
- /**
4599
- * Whether this API token can access the Content Delivery API published content endpoint
4600
- */
4601
- can_access_cda: boolean;
4602
- /**
4603
- * Whether this API token can access the Content Delivery API draft content endpoint
4604
- */
4605
- can_access_cda_preview: boolean;
4606
- /**
4607
- * Whether this API token can access the Content Management API
4608
- */
4609
- can_access_cma: boolean;
4610
- hardcoded_type: null | string;
4611
- role: RoleData | null;
4612
- };
4613
- export declare type AccessTokenCreateTargetSchema = AccessToken;
4614
- export declare type AccessTokenUpdateTargetSchema = AccessToken;
4615
- export declare type AccessTokenSelfTargetSchema = AccessToken;
4616
- export declare type AccessTokenRegenerateTokenTargetSchema = AccessToken;
4617
- export declare type AccessTokenDestroyTargetSchema = AccessToken;
4618
- /**
4619
- * JSON API data
4620
- *
4621
- * This interface was referenced by `AccessToken`'s JSON-Schema
4622
- * via the `definition` "data".
4623
- */
4624
- export declare type AccessTokenData = {
4625
- type: AccessTokenType;
4626
- id: AccessTokenIdentity;
4627
- };
4628
- /**
4629
- * JSON API attributes
4630
- *
4631
- * This interface was referenced by `AccessToken`'s JSON-Schema
4632
- * via the `definition` "attributes".
4633
- */
4634
- export declare type AccessTokenAttributes = {
4635
- /**
4636
- * Name of API token
4637
- */
4638
- name: string;
4639
- /**
4640
- * The actual API token
4641
- */
4642
- token?: string;
4643
- /**
4644
- * Whether this API token can access the Content Delivery API published content endpoint
4645
- */
4646
- can_access_cda: boolean;
4647
- /**
4648
- * Whether this API token can access the Content Delivery API draft content endpoint
4649
- */
4650
- can_access_cda_preview: boolean;
4651
- /**
4652
- * Whether this API token can access the Content Management API
4653
- */
4654
- can_access_cma: boolean;
4655
- hardcoded_type: null | string;
4656
- };
4657
- /**
4658
- * JSON API links
4659
- *
4660
- * This interface was referenced by `AccessToken`'s JSON-Schema
4661
- * via the `definition` "relationships".
4662
- */
4663
- export declare type AccessTokenRelationships = {
4664
- role: RoleData | null;
4665
- };
4666
- /**
4667
- * This interface was referenced by `AccessToken`'s JSON-Schema
4668
- * via the `create.schema` link.
4669
- */
4670
- export declare type AccessTokenCreateSchema = {
4671
- type?: AccessTokenType;
4672
- /**
4673
- * Name of API token
4674
- */
4675
- name: string;
4676
- /**
4677
- * Whether this API token can access the Content Delivery API published content endpoint
4678
- */
4679
- can_access_cda: boolean;
4680
- /**
4681
- * Whether this API token can access the Content Delivery API draft content endpoint
4682
- */
4683
- can_access_cda_preview: boolean;
4684
- /**
4685
- * Whether this API token can access the Content Management API
4686
- */
4687
- can_access_cma: boolean;
4688
- role: RoleData | null;
4689
- };
4690
- /**
4691
- * This interface was referenced by `AccessToken`'s JSON-Schema
4692
- * via the `update.schema` link.
4693
- */
4694
- export declare type AccessTokenUpdateSchema = {
4695
- id?: AccessTokenIdentity;
4696
- type?: AccessTokenType;
4697
- /**
4698
- * Name of API token
4699
- */
4700
- name: string;
4701
- /**
4702
- * Whether this API token can access the Content Delivery API published content endpoint
4703
- */
4704
- can_access_cda: boolean;
4705
- /**
4706
- * Whether this API token can access the Content Delivery API draft content endpoint
4707
- */
4708
- can_access_cda_preview: boolean;
4709
- /**
4710
- * Whether this API token can access the Content Management API
4711
- */
4712
- can_access_cma: boolean;
4713
- role: RoleData | null;
4714
- };
4715
5599
  /**
4716
5600
  * Plugins enable developers to replace DatoCMS field components with HTML5 applications so the editing experiences of the DatoCMS web app can be customized.
4717
5601
  *
@@ -6302,6 +7186,10 @@ export declare type EnvironmentMeta = {
6302
7186
  * Is this environment the primary for the project?
6303
7187
  */
6304
7188
  primary: boolean;
7189
+ /**
7190
+ * ID of the environment that's been forked to generate this one
7191
+ */
7192
+ forked_from?: string | null;
6305
7193
  };
6306
7194
  /**
6307
7195
  * JSON API data
@@ -7880,10 +8768,6 @@ export declare type Site = {
7880
8768
  * Specifies the last time when a change of data occurred
7881
8769
  */
7882
8770
  last_data_change_at: null | string;
7883
- /**
7884
- * Frontend website url
7885
- */
7886
- frontend_url: string | null;
7887
8771
  /**
7888
8772
  * Specifies whether all users of this site need to authenticate using two-factor authentication
7889
8773
  */
@@ -7967,36 +8851,26 @@ export declare type Site = {
7967
8851
  } | null;
7968
8852
  account: AccountData;
7969
8853
  /**
7970
- * The list of build trigger
7971
- */
7972
- build_triggers?: BuildTriggerData[];
7973
- /**
7974
- * The list of site menu items
7975
- */
7976
- menu_items: MenuItemData[];
7977
- /**
7978
- * The list of site SSO users
7979
- */
7980
- sso_users: SsoUserData[];
7981
- /**
7982
- * The list of site users
7983
- */
7984
- users: UserData[];
7985
- /**
7986
- * The list of site item types
8854
+ * The list item types for the site
7987
8855
  */
7988
8856
  item_types: ItemTypeData[];
7989
- /**
7990
- * Specifies the default role for newly created identity providers users
7991
- */
7992
- sso_default_role?: RoleData[];
7993
- /**
7994
- * The list of site roles
7995
- */
7996
- roles: RoleData[];
8857
+ meta: SiteMeta;
7997
8858
  };
7998
8859
  export declare type SiteSelfTargetSchema = Site;
7999
8860
  export declare type SiteUpdateJobSchema = Site;
8861
+ export declare type SiteActivateImprovedTimezoneManagementJobSchema = Site;
8862
+ /**
8863
+ * Meta attributes
8864
+ *
8865
+ * This interface was referenced by `Site`'s JSON-Schema
8866
+ * via the `definition` "meta".
8867
+ */
8868
+ export declare type SiteMeta = {
8869
+ /**
8870
+ * Whether the Improved API Timezone Management option is active or not
8871
+ */
8872
+ improved_timezone_management: boolean;
8873
+ };
8000
8874
  /**
8001
8875
  * JSON API data
8002
8876
  *
@@ -8054,10 +8928,6 @@ export declare type SiteAttributes = {
8054
8928
  * Specifies the last time when a change of data occurred
8055
8929
  */
8056
8930
  last_data_change_at: null | string;
8057
- /**
8058
- * Frontend website url
8059
- */
8060
- frontend_url: string | null;
8061
8931
  /**
8062
8932
  * Specifies whether all users of this site need to authenticate using two-factor authentication
8063
8933
  */
@@ -8149,33 +9019,9 @@ export declare type SiteAttributes = {
8149
9019
  export declare type SiteRelationships = {
8150
9020
  account: AccountData;
8151
9021
  /**
8152
- * The list of build trigger
8153
- */
8154
- build_triggers?: BuildTriggerData[];
8155
- /**
8156
- * The list of site menu items
8157
- */
8158
- menu_items: MenuItemData[];
8159
- /**
8160
- * The list of site SSO users
8161
- */
8162
- sso_users: SsoUserData[];
8163
- /**
8164
- * The list of site users
8165
- */
8166
- users: UserData[];
8167
- /**
8168
- * The list of site item types
9022
+ * The list item types for the site
8169
9023
  */
8170
9024
  item_types: ItemTypeData[];
8171
- /**
8172
- * Specifies the default role for newly created identity providers users
8173
- */
8174
- sso_default_role?: RoleData[];
8175
- /**
8176
- * The list of site roles
8177
- */
8178
- roles: RoleData[];
8179
9025
  };
8180
9026
  /**
8181
9027
  * This interface was referenced by `Site`'s JSON-Schema
@@ -8286,6 +9132,12 @@ export declare type SiteUpdateSchema = {
8286
9132
  */
8287
9133
  ip_tracking_enabled?: boolean;
8288
9134
  sso_default_role?: RoleData;
9135
+ meta?: {
9136
+ /**
9137
+ * Whether the Improved API Timezone Management option is active or not
9138
+ */
9139
+ improved_timezone_management?: boolean;
9140
+ };
8289
9141
  };
8290
9142
  /**
8291
9143
  * Through workflows it is possible to set up a precise state machine able to bring a draft content up to the final publication (and beyond), through a series of intermediate, fully customizable approval steps.