@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
@@ -91,19 +91,20 @@ export type UserType = 'user';
91
91
  export type UserInstancesTargetSchema = User[];
92
92
  /**
93
93
  * This interface was referenced by `User`'s JSON-Schema
94
- * via the `destroy.hrefSchema` link.
94
+ * via the `self.hrefSchema` link.
95
95
  */
96
- export type UserDestroyHrefSchema = {
97
- /**
98
- * New owner for resources previously owned by the deleted user. This argument specifies the new owner type.
99
- */
100
- destination_user_type?: 'account' | 'user' | 'access_token' | 'sso_user';
96
+ export type UserSelfHrefSchema = {
101
97
  /**
102
- * New owner for resources previously owned by the deleted user. This argument specifies the new owner ID.
98
+ * 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`.
103
99
  */
104
- destination_user_id?: string;
100
+ include?: string;
105
101
  [k: string]: unknown;
106
102
  };
103
+ /**
104
+ * This interface was referenced by `User`'s JSON-Schema
105
+ * via the `me.targetSchema` link.
106
+ */
107
+ export type UserMeTargetSchema = User | SsoUser | AccessToken | Account;
107
108
  /**
108
109
  * ID of user
109
110
  *
@@ -164,27 +165,42 @@ export type SsoUserDestroyHrefSchema = {
164
165
  [k: string]: unknown;
165
166
  };
166
167
  /**
167
- * ULID of event (https://github.com/ulid/spec)
168
+ * ID of access_token
168
169
  *
169
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
170
+ * This interface was referenced by `AccessToken`'s JSON-Schema
170
171
  * via the `definition` "identity".
171
172
  *
172
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
173
+ * This interface was referenced by `AccessToken`'s JSON-Schema
173
174
  * via the `definition` "id".
174
175
  */
175
- export type AuditLogEventIdentity = string;
176
+ export type AccessTokenIdentity = string;
176
177
  /**
177
178
  * JSON API type field
178
179
  *
179
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
180
+ * This interface was referenced by `AccessToken`'s JSON-Schema
180
181
  * via the `definition` "type".
181
182
  */
182
- export type AuditLogEventType = 'audit_log_event';
183
+ export type AccessTokenType = 'access_token';
183
184
  /**
184
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
185
- * via the `query.targetSchema` link.
185
+ * This interface was referenced by `AccessToken`'s JSON-Schema
186
+ * via the `instances.targetSchema` link.
186
187
  */
187
- export type AuditLogEventQueryTargetSchema = AuditLogEvent[];
188
+ export type AccessTokenInstancesTargetSchema = AccessToken[];
189
+ /**
190
+ * This interface was referenced by `AccessToken`'s JSON-Schema
191
+ * via the `destroy.hrefSchema` link.
192
+ */
193
+ export type AccessTokenDestroyHrefSchema = {
194
+ /**
195
+ * New owner for resources previously owned by the deleted access token. This argument specifies the new owner type.
196
+ */
197
+ destination_user_type?: 'account' | 'user' | 'access_token' | 'sso_user';
198
+ /**
199
+ * New owner for resources previously owned by the deleted access token. This argument specifies the new owner ID.
200
+ */
201
+ destination_user_id?: string;
202
+ [k: string]: unknown;
203
+ };
188
204
  /**
189
205
  * ID of account
190
206
  *
@@ -202,6 +218,54 @@ export type AccountIdentity = string;
202
218
  * via the `definition` "type".
203
219
  */
204
220
  export type AccountType = 'account';
221
+ /**
222
+ * This interface was referenced by `User`'s JSON-Schema
223
+ * via the `me.hrefSchema` link.
224
+ */
225
+ export type UserMeHrefSchema = {
226
+ /**
227
+ * 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`.
228
+ */
229
+ include?: string;
230
+ [k: string]: unknown;
231
+ };
232
+ /**
233
+ * This interface was referenced by `User`'s JSON-Schema
234
+ * via the `destroy.hrefSchema` link.
235
+ */
236
+ export type UserDestroyHrefSchema = {
237
+ /**
238
+ * New owner for resources previously owned by the deleted user. This argument specifies the new owner type.
239
+ */
240
+ destination_user_type?: 'account' | 'user' | 'access_token' | 'sso_user';
241
+ /**
242
+ * New owner for resources previously owned by the deleted user. This argument specifies the new owner ID.
243
+ */
244
+ destination_user_id?: string;
245
+ [k: string]: unknown;
246
+ };
247
+ /**
248
+ * ULID of event (https://github.com/ulid/spec)
249
+ *
250
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
251
+ * via the `definition` "identity".
252
+ *
253
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
254
+ * via the `definition` "id".
255
+ */
256
+ export type AuditLogEventIdentity = string;
257
+ /**
258
+ * JSON API type field
259
+ *
260
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
261
+ * via the `definition` "type".
262
+ */
263
+ export type AuditLogEventType = 'audit_log_event';
264
+ /**
265
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
266
+ * via the `query.targetSchema` link.
267
+ */
268
+ export type AuditLogEventQueryTargetSchema = AuditLogEvent[];
205
269
  /**
206
270
  * ID of plan
207
271
  *
@@ -294,6 +358,23 @@ export type FieldType = 'field';
294
358
  * via the `definition` "id".
295
359
  */
296
360
  export type FieldIdentity = string;
361
+ /**
362
+ * JSON API type fieldset
363
+ *
364
+ * This interface was referenced by `Fieldset`'s JSON-Schema
365
+ * via the `definition` "type".
366
+ */
367
+ export type FieldsetType = 'fieldset';
368
+ /**
369
+ * ID of fieldset
370
+ *
371
+ * This interface was referenced by `Fieldset`'s JSON-Schema
372
+ * via the `definition` "identity".
373
+ *
374
+ * This interface was referenced by `Fieldset`'s JSON-Schema
375
+ * via the `definition` "id".
376
+ */
377
+ export type FieldsetIdentity = string;
297
378
  /**
298
379
  * JSON API type field
299
380
  *
@@ -323,23 +404,6 @@ export type JobType = 'job';
323
404
  * via the `instances.targetSchema` link.
324
405
  */
325
406
  export type ItemTypeInstancesTargetSchema = ItemType[];
326
- /**
327
- * JSON API type fieldset
328
- *
329
- * This interface was referenced by `Fieldset`'s JSON-Schema
330
- * via the `definition` "type".
331
- */
332
- export type FieldsetType = 'fieldset';
333
- /**
334
- * ID of fieldset
335
- *
336
- * This interface was referenced by `Fieldset`'s JSON-Schema
337
- * via the `definition` "identity".
338
- *
339
- * This interface was referenced by `Fieldset`'s JSON-Schema
340
- * via the `definition` "id".
341
- */
342
- export type FieldsetIdentity = string;
343
407
  /**
344
408
  * This interface was referenced by `Field`'s JSON-Schema
345
409
  * via the `instances.targetSchema` link.
@@ -377,43 +441,6 @@ export type SessionIdentity = string;
377
441
  * via the `definition` "type".
378
442
  */
379
443
  export type SessionType = 'session';
380
- /**
381
- * ID of access_token
382
- *
383
- * This interface was referenced by `AccessToken`'s JSON-Schema
384
- * via the `definition` "identity".
385
- *
386
- * This interface was referenced by `AccessToken`'s JSON-Schema
387
- * via the `definition` "id".
388
- */
389
- export type AccessTokenIdentity = string;
390
- /**
391
- * JSON API type field
392
- *
393
- * This interface was referenced by `AccessToken`'s JSON-Schema
394
- * via the `definition` "type".
395
- */
396
- export type AccessTokenType = 'access_token';
397
- /**
398
- * This interface was referenced by `AccessToken`'s JSON-Schema
399
- * via the `instances.targetSchema` link.
400
- */
401
- export type AccessTokenInstancesTargetSchema = AccessToken[];
402
- /**
403
- * This interface was referenced by `AccessToken`'s JSON-Schema
404
- * via the `destroy.hrefSchema` link.
405
- */
406
- export type AccessTokenDestroyHrefSchema = {
407
- /**
408
- * New owner for resources previously owned by the deleted access token. This argument specifies the new owner type.
409
- */
410
- destination_user_type?: 'account' | 'user' | 'access_token' | 'sso_user';
411
- /**
412
- * New owner for resources previously owned by the deleted access token. This argument specifies the new owner ID.
413
- */
414
- destination_user_id?: string;
415
- [k: string]: unknown;
416
- };
417
444
  /**
418
445
  * ID of plugin
419
446
  *
@@ -1490,6 +1517,17 @@ export type SiteIdentity = string;
1490
1517
  * via the `definition` "type".
1491
1518
  */
1492
1519
  export type SiteType = 'site';
1520
+ /**
1521
+ * This interface was referenced by `Site`'s JSON-Schema
1522
+ * via the `self.hrefSchema` link.
1523
+ */
1524
+ export type SiteSelfHrefSchema = {
1525
+ /**
1526
+ * 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`.
1527
+ */
1528
+ include?: string;
1529
+ [k: string]: unknown;
1530
+ };
1493
1531
  /**
1494
1532
  * This interface was referenced by `Workflow`'s JSON-Schema
1495
1533
  * via the `instances.targetSchema` link.
@@ -2926,133 +2964,224 @@ export type SsoUserRelationships = {
2926
2964
  };
2927
2965
 
2928
2966
  /**
2929
- * 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.
2967
+ * An API token allows access to our API. It is linked to a Role, which describes what actions can be performed.
2930
2968
  *
2931
2969
  * This interface was referenced by `DatoApi`'s JSON-Schema
2932
- * via the `definition` "audit_log_event".
2970
+ * via the `definition` "access_token".
2933
2971
  */
2934
- export type AuditLogEvent = {
2935
- id: AuditLogEventIdentity;
2936
- type: AuditLogEventType;
2937
- /**
2938
- * The actual action performed
2939
- */
2940
- action_name: string;
2972
+ export type AccessToken = {
2973
+ id: AccessTokenIdentity;
2974
+ type: AccessTokenType;
2941
2975
  /**
2942
- * The actor who performed the action
2976
+ * Name of API token
2943
2977
  */
2944
- actor: {
2945
- /**
2946
- * The type of actor (can be `account`, `user`, `sso_user` or `access_token`)
2947
- */
2948
- type: string;
2949
- /**
2950
- * The ID of the actor
2951
- */
2952
- id: string;
2953
- /**
2954
- * An human representation of the actor (name/email/username depending on the type of actor)
2955
- */
2956
- name: string;
2957
- };
2978
+ name: string;
2958
2979
  /**
2959
- * The role of the actor at the time the action was performed
2980
+ * The actual API token (or null if the current user has no permission to read the token)
2960
2981
  */
2961
- role: null | {
2962
- /**
2963
- * The name of the role
2964
- */
2965
- name: string;
2966
- /**
2967
- * The ID of the role
2968
- */
2969
- id: string;
2970
- };
2982
+ token?: null | string;
2971
2983
  /**
2972
- * The environment inside of which the action was performed
2984
+ * Whether this API token can access the Content Delivery API published content endpoint
2973
2985
  */
2974
- environment: {
2975
- /**
2976
- * The ID of the environment
2977
- */
2978
- id: string;
2979
- /**
2980
- * Whether the environment was the primary one at the time the action was performed
2981
- */
2982
- primary: boolean;
2983
- };
2986
+ can_access_cda: boolean;
2984
2987
  /**
2985
- * The actual request being performed
2988
+ * Whether this API token can access the Content Delivery API draft content endpoint
2986
2989
  */
2987
- request: {
2988
- /**
2989
- * The full path of the request
2990
- */
2991
- path: string;
2992
- /**
2993
- * The HTTP method of the request
2994
- */
2995
- method: string;
2996
- /**
2997
- * The X-Request-ID header of the request
2998
- */
2999
- id?: string;
3000
- /**
3001
- * The full HTTP body of the request
3002
- */
3003
- payload?: null | {
3004
- [k: string]: unknown;
3005
- };
3006
- };
2990
+ can_access_cda_preview: boolean;
3007
2991
  /**
3008
- * The actual response being returned by DatoCMS
2992
+ * Whether this API token can access the Content Management API
3009
2993
  */
3010
- response: null | {
3011
- /**
3012
- * The HTTP status code of the response
3013
- */
3014
- status: number;
3015
- /**
3016
- * The full HTTP body of the response
3017
- */
3018
- payload: {
3019
- [k: string]: unknown;
3020
- };
3021
- };
3022
- meta: AuditLogEventMeta;
2994
+ can_access_cma: boolean;
2995
+ hardcoded_type: null | string;
2996
+ role: RoleData | null;
2997
+ };
2998
+ export type AccessTokenCreateTargetSchema = AccessToken;
2999
+ export type AccessTokenUpdateTargetSchema = AccessToken;
3000
+ export type AccessTokenSelfTargetSchema = AccessToken;
3001
+ export type AccessTokenRegenerateTokenTargetSchema = AccessToken;
3002
+ export type AccessTokenDestroyTargetSchema = AccessToken;
3003
+ /**
3004
+ * JSON API data
3005
+ *
3006
+ * This interface was referenced by `AccessToken`'s JSON-Schema
3007
+ * via the `definition` "data".
3008
+ */
3009
+ export type AccessTokenData = {
3010
+ type: AccessTokenType;
3011
+ id: AccessTokenIdentity;
3023
3012
  };
3024
3013
 
3025
3014
  /**
3026
- * JSON API meta
3015
+ * JSON API attributes
3027
3016
  *
3028
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
3029
- * via the `definition` "meta".
3017
+ * This interface was referenced by `AccessToken`'s JSON-Schema
3018
+ * via the `definition` "attributes".
3030
3019
  */
3031
- export type AuditLogEventMeta = {
3020
+ export type AccessTokenAttributes = {
3032
3021
  /**
3033
- * The date of the event
3022
+ * Name of API token
3034
3023
  */
3035
- occurred_at: string;
3024
+ name: string;
3025
+ /**
3026
+ * The actual API token (or null if the current user has no permission to read the token)
3027
+ */
3028
+ token?: null | string;
3029
+ /**
3030
+ * Whether this API token can access the Content Delivery API published content endpoint
3031
+ */
3032
+ can_access_cda: boolean;
3033
+ /**
3034
+ * Whether this API token can access the Content Delivery API draft content endpoint
3035
+ */
3036
+ can_access_cda_preview: boolean;
3037
+ /**
3038
+ * Whether this API token can access the Content Management API
3039
+ */
3040
+ can_access_cma: boolean;
3041
+ hardcoded_type: null | string;
3042
+ };
3043
+
3044
+ /**
3045
+ * JSON API links
3046
+ *
3047
+ * This interface was referenced by `AccessToken`'s JSON-Schema
3048
+ * via the `definition` "relationships".
3049
+ */
3050
+ export type AccessTokenRelationships = {
3051
+ role: RoleData | null;
3052
+ };
3053
+
3054
+ /**
3055
+ * This interface was referenced by `AccessToken`'s JSON-Schema
3056
+ * via the `create.schema` link.
3057
+ */
3058
+ export type AccessTokenCreateSchema = {
3059
+ type?: AccessTokenType;
3060
+ /**
3061
+ * Name of API token
3062
+ */
3063
+ name: string;
3064
+ /**
3065
+ * Whether this API token can access the Content Delivery API published content endpoint
3066
+ */
3067
+ can_access_cda: boolean;
3068
+ /**
3069
+ * Whether this API token can access the Content Delivery API draft content endpoint
3070
+ */
3071
+ can_access_cda_preview: boolean;
3072
+ /**
3073
+ * Whether this API token can access the Content Management API
3074
+ */
3075
+ can_access_cma: boolean;
3076
+ role: RoleData | null;
3077
+ };
3078
+
3079
+ /**
3080
+ * This interface was referenced by `AccessToken`'s JSON-Schema
3081
+ * via the `update.schema` link.
3082
+ */
3083
+ export type AccessTokenUpdateSchema = {
3084
+ id?: AccessTokenIdentity;
3085
+ type?: AccessTokenType;
3086
+ /**
3087
+ * Name of API token
3088
+ */
3089
+ name: string;
3090
+ /**
3091
+ * Whether this API token can access the Content Delivery API published content endpoint
3092
+ */
3093
+ can_access_cda: boolean;
3094
+ /**
3095
+ * Whether this API token can access the Content Delivery API draft content endpoint
3096
+ */
3097
+ can_access_cda_preview: boolean;
3098
+ /**
3099
+ * Whether this API token can access the Content Management API
3100
+ */
3101
+ can_access_cma: boolean;
3102
+ role: RoleData | null;
3103
+ };
3104
+
3105
+ /**
3106
+ * DatoCMS account
3107
+ *
3108
+ * This interface was referenced by `DatoApi`'s JSON-Schema
3109
+ * via the `definition` "account".
3110
+ */
3111
+ export type Account = {
3112
+ id: AccountIdentity;
3113
+ type: AccountType;
3114
+ /**
3115
+ * Email
3116
+ */
3117
+ email: string;
3118
+ /**
3119
+ * First name
3120
+ */
3121
+ first_name: string | null;
3122
+ /**
3123
+ * Last name
3124
+ */
3125
+ last_name: string | null;
3126
+ /**
3127
+ * Company name
3128
+ */
3129
+ company: string | null;
3130
+ /**
3131
+ * Password
3132
+ */
3133
+ password?: string;
3036
3134
  };
3037
3135
 
3038
3136
  /**
3039
3137
  * JSON API data
3040
3138
  *
3041
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
3139
+ * This interface was referenced by `Account`'s JSON-Schema
3042
3140
  * via the `definition` "data".
3043
3141
  */
3044
- export type AuditLogEventData = {
3045
- type: AuditLogEventType;
3046
- id: AuditLogEventIdentity;
3142
+ export type AccountData = {
3143
+ type: AccountType;
3144
+ id: AccountIdentity;
3047
3145
  };
3048
3146
 
3049
3147
  /**
3050
3148
  * JSON API attributes
3051
3149
  *
3052
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
3150
+ * This interface was referenced by `Account`'s JSON-Schema
3053
3151
  * via the `definition` "attributes".
3054
3152
  */
3055
- export type AuditLogEventAttributes = {
3153
+ export type AccountAttributes = {
3154
+ /**
3155
+ * Email
3156
+ */
3157
+ email: string;
3158
+ /**
3159
+ * First name
3160
+ */
3161
+ first_name: string | null;
3162
+ /**
3163
+ * Last name
3164
+ */
3165
+ last_name: string | null;
3166
+ /**
3167
+ * Company name
3168
+ */
3169
+ company: string | null;
3170
+ /**
3171
+ * Password
3172
+ */
3173
+ password?: string;
3174
+ };
3175
+
3176
+ /**
3177
+ * 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.
3178
+ *
3179
+ * This interface was referenced by `DatoApi`'s JSON-Schema
3180
+ * via the `definition` "audit_log_event".
3181
+ */
3182
+ export type AuditLogEvent = {
3183
+ id: AuditLogEventIdentity;
3184
+ type: AuditLogEventType;
3056
3185
  /**
3057
3186
  * The actual action performed
3058
3187
  */
@@ -3138,100 +3267,148 @@ export type AuditLogEventAttributes = {
3138
3267
  [k: string]: unknown;
3139
3268
  };
3140
3269
  };
3270
+ meta: AuditLogEventMeta;
3141
3271
  };
3142
3272
 
3143
3273
  /**
3144
- * This interface was referenced by `AuditLogEvent`'s JSON-Schema
3145
- * via the `query.schema` link.
3146
- */
3147
- export type AuditLogEventQuerySchema = {
3148
- /**
3149
- * JSON API type field
3150
- */
3151
- type?: 'audit_log_query';
3152
- /**
3153
- * An SQL-like expression to filter the events
3154
- */
3155
- filter?: string;
3156
- /**
3157
- * Set this value to get remaining results, if a meta.next_token was returned in the previous query response
3158
- */
3159
- next_token?: string;
3160
- /**
3161
- * Whether a detailed log complete with full request and response payload must be returned or not
3162
- */
3163
- detailed_log?: boolean;
3164
- };
3165
-
3166
- /**
3167
- * DatoCMS account
3274
+ * JSON API meta
3168
3275
  *
3169
- * This interface was referenced by `DatoApi`'s JSON-Schema
3170
- * via the `definition` "account".
3276
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
3277
+ * via the `definition` "meta".
3171
3278
  */
3172
- export type Account = {
3173
- id: AccountIdentity;
3174
- type: AccountType;
3175
- /**
3176
- * Email
3177
- */
3178
- email: string;
3179
- /**
3180
- * First name
3181
- */
3182
- first_name: string | null;
3183
- /**
3184
- * Last name
3185
- */
3186
- last_name: string | null;
3187
- /**
3188
- * Company name
3189
- */
3190
- company: string | null;
3279
+ export type AuditLogEventMeta = {
3191
3280
  /**
3192
- * Password
3281
+ * The date of the event
3193
3282
  */
3194
- password?: string;
3283
+ occurred_at: string;
3195
3284
  };
3196
3285
 
3197
3286
  /**
3198
3287
  * JSON API data
3199
3288
  *
3200
- * This interface was referenced by `Account`'s JSON-Schema
3289
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
3201
3290
  * via the `definition` "data".
3202
3291
  */
3203
- export type AccountData = {
3204
- type: AccountType;
3205
- id: AccountIdentity;
3292
+ export type AuditLogEventData = {
3293
+ type: AuditLogEventType;
3294
+ id: AuditLogEventIdentity;
3206
3295
  };
3207
3296
 
3208
3297
  /**
3209
3298
  * JSON API attributes
3210
3299
  *
3211
- * This interface was referenced by `Account`'s JSON-Schema
3300
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
3212
3301
  * via the `definition` "attributes".
3213
3302
  */
3214
- export type AccountAttributes = {
3303
+ export type AuditLogEventAttributes = {
3215
3304
  /**
3216
- * Email
3305
+ * The actual action performed
3217
3306
  */
3218
- email: string;
3307
+ action_name: string;
3219
3308
  /**
3220
- * First name
3309
+ * The actor who performed the action
3221
3310
  */
3222
- first_name: string | null;
3311
+ actor: {
3312
+ /**
3313
+ * The type of actor (can be `account`, `user`, `sso_user` or `access_token`)
3314
+ */
3315
+ type: string;
3316
+ /**
3317
+ * The ID of the actor
3318
+ */
3319
+ id: string;
3320
+ /**
3321
+ * An human representation of the actor (name/email/username depending on the type of actor)
3322
+ */
3323
+ name: string;
3324
+ };
3223
3325
  /**
3224
- * Last name
3326
+ * The role of the actor at the time the action was performed
3225
3327
  */
3226
- last_name: string | null;
3328
+ role: null | {
3329
+ /**
3330
+ * The name of the role
3331
+ */
3332
+ name: string;
3333
+ /**
3334
+ * The ID of the role
3335
+ */
3336
+ id: string;
3337
+ };
3227
3338
  /**
3228
- * Company name
3339
+ * The environment inside of which the action was performed
3229
3340
  */
3230
- company: string | null;
3341
+ environment: {
3342
+ /**
3343
+ * The ID of the environment
3344
+ */
3345
+ id: string;
3346
+ /**
3347
+ * Whether the environment was the primary one at the time the action was performed
3348
+ */
3349
+ primary: boolean;
3350
+ };
3231
3351
  /**
3232
- * Password
3352
+ * The actual request being performed
3233
3353
  */
3234
- password?: string;
3354
+ request: {
3355
+ /**
3356
+ * The full path of the request
3357
+ */
3358
+ path: string;
3359
+ /**
3360
+ * The HTTP method of the request
3361
+ */
3362
+ method: string;
3363
+ /**
3364
+ * The X-Request-ID header of the request
3365
+ */
3366
+ id?: string;
3367
+ /**
3368
+ * The full HTTP body of the request
3369
+ */
3370
+ payload?: null | {
3371
+ [k: string]: unknown;
3372
+ };
3373
+ };
3374
+ /**
3375
+ * The actual response being returned by DatoCMS
3376
+ */
3377
+ response: null | {
3378
+ /**
3379
+ * The HTTP status code of the response
3380
+ */
3381
+ status: number;
3382
+ /**
3383
+ * The full HTTP body of the response
3384
+ */
3385
+ payload: {
3386
+ [k: string]: unknown;
3387
+ };
3388
+ };
3389
+ };
3390
+
3391
+ /**
3392
+ * This interface was referenced by `AuditLogEvent`'s JSON-Schema
3393
+ * via the `query.schema` link.
3394
+ */
3395
+ export type AuditLogEventQuerySchema = {
3396
+ /**
3397
+ * JSON API type field
3398
+ */
3399
+ type?: 'audit_log_query';
3400
+ /**
3401
+ * An SQL-like expression to filter the events
3402
+ */
3403
+ filter?: string;
3404
+ /**
3405
+ * Set this value to get remaining results, if a meta.next_token was returned in the previous query response
3406
+ */
3407
+ next_token?: string;
3408
+ /**
3409
+ * Whether a detailed log complete with full request and response payload must be returned or not
3410
+ */
3411
+ detailed_log?: boolean;
3235
3412
  };
3236
3413
 
3237
3414
  /**
@@ -3387,6 +3564,10 @@ export type SitePlan = {
3387
3564
  * Whether translator roles are enabled or not
3388
3565
  */
3389
3566
  translator_roles: boolean;
3567
+ /**
3568
+ * Whether or not use a static IP when sending webhooks
3569
+ */
3570
+ static_webhooks_ip: boolean;
3390
3571
  /**
3391
3572
  * Available extra packets
3392
3573
  */
@@ -3605,6 +3786,10 @@ export type SitePlanAttributes = {
3605
3786
  * Whether translator roles are enabled or not
3606
3787
  */
3607
3788
  translator_roles: boolean;
3789
+ /**
3790
+ * Whether or not use a static IP when sending webhooks
3791
+ */
3792
+ static_webhooks_ip: boolean;
3608
3793
  /**
3609
3794
  * Available extra packets
3610
3795
  */
@@ -3878,6 +4063,7 @@ export type ItemType = {
3878
4063
  hint: string | null;
3879
4064
  singleton_item: ItemData | null;
3880
4065
  fields: FieldData[];
4066
+ fieldsets: FieldsetData[];
3881
4067
  title_field: FieldData | null;
3882
4068
  image_preview_field: FieldData | null;
3883
4069
  excerpt_field: FieldData | null;
@@ -3911,6 +4097,17 @@ export type FieldData = {
3911
4097
  id: FieldIdentity;
3912
4098
  };
3913
4099
 
4100
+ /**
4101
+ * JSON API data
4102
+ *
4103
+ * This interface was referenced by `Fieldset`'s JSON-Schema
4104
+ * via the `definition` "data".
4105
+ */
4106
+ export type FieldsetData = {
4107
+ type: FieldsetType;
4108
+ id: FieldsetIdentity;
4109
+ };
4110
+
3914
4111
  /**
3915
4112
  * JSON API data
3916
4113
  *
@@ -4001,6 +4198,7 @@ export type ItemTypeAttributes = {
4001
4198
  export type ItemTypeRelationships = {
4002
4199
  singleton_item: ItemData | null;
4003
4200
  fields: FieldData[];
4201
+ fieldsets: FieldsetData[];
4004
4202
  title_field: FieldData | null;
4005
4203
  image_preview_field: FieldData | null;
4006
4204
  excerpt_field: FieldData | null;
@@ -4190,82 +4388,918 @@ export type ItemTypeUpdateSchema = {
4190
4388
  * This interface was referenced by `Item`'s JSON-Schema
4191
4389
  * via the `bulk_publish.targetSchema` link.
4192
4390
  *
4193
- * This interface was referenced by `Item`'s JSON-Schema
4194
- * via the `bulk_unpublish.targetSchema` link.
4391
+ * This interface was referenced by `Item`'s JSON-Schema
4392
+ * via the `bulk_unpublish.targetSchema` link.
4393
+ *
4394
+ * This interface was referenced by `Item`'s JSON-Schema
4395
+ * via the `bulk_destroy.targetSchema` link.
4396
+ *
4397
+ * This interface was referenced by `Item`'s JSON-Schema
4398
+ * via the `bulk_move_to_stage.targetSchema` link.
4399
+ *
4400
+ * This interface was referenced by `ItemVersion`'s JSON-Schema
4401
+ * via the `restore.targetSchema` link.
4402
+ *
4403
+ * This interface was referenced by `Upload`'s JSON-Schema
4404
+ * via the `create.targetSchema` link.
4405
+ *
4406
+ * This interface was referenced by `Upload`'s JSON-Schema
4407
+ * via the `update.targetSchema` link.
4408
+ *
4409
+ * This interface was referenced by `Upload`'s JSON-Schema
4410
+ * via the `batch_add_tags.targetSchema` link.
4411
+ *
4412
+ * This interface was referenced by `Upload`'s JSON-Schema
4413
+ * via the `batch_destroy.targetSchema` link.
4414
+ *
4415
+ * This interface was referenced by `Upload`'s JSON-Schema
4416
+ * via the `bulk_tag.targetSchema` link.
4417
+ *
4418
+ * This interface was referenced by `Upload`'s JSON-Schema
4419
+ * via the `bulk_destroy.targetSchema` link.
4420
+ *
4421
+ * This interface was referenced by `Site`'s JSON-Schema
4422
+ * via the `update.targetSchema` link.
4423
+ *
4424
+ * This interface was referenced by `Site`'s JSON-Schema
4425
+ * via the `activate_improved_timezone_management.targetSchema` link.
4426
+ *
4427
+ * This interface was referenced by `DatoApi`'s JSON-Schema
4428
+ * via the `definition` "job".
4429
+ */
4430
+ export type Job = {
4431
+ id: JobIdentity;
4432
+ type: JobType;
4433
+ };
4434
+ export type ItemTypeUpdateTargetSchema = Job;
4435
+ export type ItemTypeDestroyTargetSchema = Job;
4436
+ export type FieldCreateTargetSchema = Job;
4437
+ export type FieldUpdateTargetSchema = Job;
4438
+ export type FieldDestroyTargetSchema = Job;
4439
+ export type FieldDuplicateTargetSchema = Job;
4440
+ export type ItemDuplicateTargetSchema = Job;
4441
+ export type ItemDestroyTargetSchema = Job;
4442
+ export type ItemBatchDestroyTargetSchema = Job;
4443
+ export type ItemBatchPublishTargetSchema = Job;
4444
+ export type ItemBatchUnpublishTargetSchema = Job;
4445
+ export type ItemBulkPublishTargetSchema = Job;
4446
+ export type ItemBulkUnpublishTargetSchema = Job;
4447
+ export type ItemBulkDestroyTargetSchema = Job;
4448
+ export type ItemBulkMoveToStageTargetSchema = Job;
4449
+ export type ItemVersionRestoreTargetSchema = Job;
4450
+ export type UploadCreateTargetSchema = Job;
4451
+ export type UploadUpdateTargetSchema = Job;
4452
+ export type UploadBatchAddTagsTargetSchema = Job;
4453
+ export type UploadBatchDestroyTargetSchema = Job;
4454
+ export type UploadBulkTagTargetSchema = Job;
4455
+ export type UploadBulkDestroyTargetSchema = Job;
4456
+ export type SiteUpdateTargetSchema = Job;
4457
+ export type SiteActivateImprovedTimezoneManagementTargetSchema = Job;
4458
+ /**
4459
+ * JSON API data
4460
+ *
4461
+ * This interface was referenced by `Job`'s JSON-Schema
4462
+ * via the `definition` "data".
4463
+ */
4464
+ export type JobData = {
4465
+ type: JobType;
4466
+ id: JobIdentity;
4467
+ };
4468
+
4469
+ /**
4470
+ * 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.
4471
+ *
4472
+ * ### Different field types require different settings
4473
+ *
4474
+ * When looking at a field resource, you have to pay attention to two particular properties, `validators` and `appearance`.
4475
+ *
4476
+ * 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.
4477
+ *
4478
+ * 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.
4479
+ *
4480
+ * ### Specifying validations
4481
+ *
4482
+ * 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.
4483
+ *
4484
+ * This is a valid example for a _Single-line string_ field:
4485
+ *
4486
+ * ```js
4487
+ * {
4488
+ * "validators": {
4489
+ * // "required" validator has no settings
4490
+ * "required": {},
4491
+ * // "length" validator requires "min" and/or "max" properties
4492
+ * "length": { "min": 80 }
4493
+ * }
4494
+ * }
4495
+ * ```
4496
+ *
4497
+ * Below you'll find a summary of all the validators available for each field type with their settings.
4498
+ *
4499
+ * 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.
4500
+ *
4501
+ * ### Specifying the appearance
4502
+ *
4503
+ * The `appearance` property requires an object with three specific properties: `editor`, `parameters` and `addons`.
4504
+ *
4505
+ * 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.
4506
+ *
4507
+ * This is a valid example for a _Single-line string_ field:
4508
+ *
4509
+ * ```js
4510
+ * {
4511
+ * "appearance": {
4512
+ * // single_line is a DatoCMS built-in editor that you can use with single-line string fields
4513
+ * "editor": "single_line",
4514
+ * // each built-in editor has specific settings
4515
+ * "parameters": { "heading": true },
4516
+ * "addons": []
4517
+ * },
4518
+ * }
4519
+ * ```
4520
+ *
4521
+ * Following you'll find a summary of all the editors available for each field type with their settings.
4522
+ *
4523
+ * #### Setting the appearance to a field editor provided by a plugin
4524
+ *
4525
+ * 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.
4526
+ *
4527
+ * In this case:
4528
+ *
4529
+ * - the `editor` property must be the ID of the plugin;
4530
+ * - the `field_extension` property must be the ID of the specific manual field editor that the plugin exposes;
4531
+ * - 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.
4532
+ *
4533
+ * ```js
4534
+ * {
4535
+ * "appearance": {
4536
+ * // "2132" is a the ID of a plugin exposing a manual field editor
4537
+ * "editor": "2134",
4538
+ * // "starRating" is a manual field editor exposed by the plugin
4539
+ * "field_extension": "starRating",
4540
+ * // this is a valid configuration for the "starRating" field editor
4541
+ * "parameters": { "maxRating": 5, "starsColor": "#ff0000" },
4542
+ * "addons": []
4543
+ * },
4544
+ * }
4545
+ * ```
4546
+ *
4547
+ * #### Configuring manual field addons
4548
+ *
4549
+ * 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.
4550
+ *
4551
+ * ```js
4552
+ * {
4553
+ * "appearance": {
4554
+ * "editor": "single_line",
4555
+ * "parameters": { "heading": true },
4556
+ * "addons": [
4557
+ * {
4558
+ * // "2138" is a the ID of a plugin exposing a manual addon editor
4559
+ * "id": "2138",
4560
+ * // "loremIpsumGenerator" is a manual field addon exposed by the plugin
4561
+ * "field_extension": "loremIpsumGenerator",
4562
+ * // this is a valid configuration for the "loremIpsumGenerator" field addon
4563
+ * "parameters": { "sentences": 2 },
4564
+ * }
4565
+ * ]
4566
+ * },
4567
+ * }
4568
+ * ```
4569
+ *
4570
+ * ### Available field types
4571
+ *
4572
+ * <details>
4573
+ * <summary>Single-line string (<code>string</code>)</summary>
4574
+ *
4575
+ * | Property | Value |
4576
+ * | ------------------------------ | ---------------------------------------------------- |
4577
+ * | Code | `string` |
4578
+ * | Built-in editors for the field | `single_line`, `string_radio_group`, `string_select` |
4579
+ * | Available validators | `required`, `unique`, `length`, `format`, `enum` |
4580
+ *
4581
+ * </details>
4582
+ *
4583
+ * <details>
4584
+ * <summary>Multi-line text (<code>text</code>)</summary>
4585
+ *
4586
+ * | Property | Value |
4587
+ * | ------------------------------ | --------------------------------- |
4588
+ * | Code | `text` |
4589
+ * | Built-in editors for the field | `markdown`, `wysiwyg`, `textarea` |
4590
+ * | Available validators | `required`, `length`, `format` |
4591
+ *
4592
+ * </details>
4593
+ *
4594
+ * <details>
4595
+ * <summary>Boolean (<code>boolean</code>)</summary>
4596
+ *
4597
+ * | Property | Value |
4598
+ * | ------------------------------ | -------------------------------- |
4599
+ * | Code | `boolean` |
4600
+ * | Built-in editors for the field | `boolean`, `boolean_radio_group` |
4601
+ * | Available validators | no validators available |
4602
+ *
4603
+ * </details>
4604
+ *
4605
+ * <details>
4606
+ * <summary>Integer (<code>integer</code>)</summary>
4607
+ *
4608
+ * | Property | Value |
4609
+ * | ------------------------------ | -------------------------- |
4610
+ * | Code | `integer` |
4611
+ * | Built-in editors for the field | `integer` |
4612
+ * | Available validators | `required`, `number_range` |
4613
+ *
4614
+ * </details>
4615
+ *
4616
+ * <details>
4617
+ * <summary>Float (<code>float</code>)</summary>
4618
+ *
4619
+ * | Property | Value |
4620
+ * | ------------------------------ | -------------------------- |
4621
+ * | Code | `float` |
4622
+ * | Built-in editors for the field | `float` |
4623
+ * | Available validators | `required`, `number_range` |
4624
+ *
4625
+ * </details>
4626
+ *
4627
+ * <details>
4628
+ * <summary>Date (<code>date</code>)</summary>
4629
+ *
4630
+ * | Property | Value |
4631
+ * | ------------------------------ | ------------------------ |
4632
+ * | Code | `date` |
4633
+ * | Built-in editors for the field | `date_picker` |
4634
+ * | Available validators | `required`, `date_range` |
4635
+ *
4636
+ * </details>
4637
+ *
4638
+ * <details>
4639
+ * <summary>Date time (<code>date_time</code>)</summary>
4640
+ *
4641
+ * | Property | Value |
4642
+ * | ------------------------------ | ----------------------------- |
4643
+ * | Code | `date_time` |
4644
+ * | Built-in editors for the field | `date_time_picker` |
4645
+ * | Available validators | `required`, `date_time_range` |
4646
+ *
4647
+ * </details>
4648
+ *
4649
+ * <details>
4650
+ * <summary>Color (<code>color</code>)</summary>
4651
+ *
4652
+ * | Property | Value |
4653
+ * | ------------------------------ | -------------- |
4654
+ * | Code | `color` |
4655
+ * | Built-in editors for the field | `color_picker` |
4656
+ * | Available validators | `required` |
4657
+ *
4658
+ * </details>
4659
+ *
4660
+ * <details>
4661
+ * <summary>JSON (<code>json</code>)</summary>
4662
+ *
4663
+ * | Property | Value |
4664
+ * | ------------------------------ | ------------------------------------------------------ |
4665
+ * | Code | `json` |
4666
+ * | Built-in editors for the field | `json`, `string_multi_select`, `string_checkbox_group` |
4667
+ * | Available validators | `required` |
4668
+ *
4669
+ * </details>
4670
+ *
4671
+ * <details>
4672
+ * <summary>Location (<code>lat_lon</code>)</summary>
4673
+ *
4674
+ * | Property | Value |
4675
+ * | ------------------------------ | ---------- |
4676
+ * | Code | `lat_lon` |
4677
+ * | Built-in editors for the field | `map` |
4678
+ * | Available validators | `required` |
4679
+ *
4680
+ * </details>
4681
+ *
4682
+ * <details>
4683
+ * <summary>SEO (<code>seo</code>)</summary>
4684
+ *
4685
+ * | Property | Value |
4686
+ * | ------------------------------ | -------------------------------------------------------------------------------------------- |
4687
+ * | Code | `seo` |
4688
+ * | Built-in editors for the field | `seo` |
4689
+ * | Available validators | `required_seo_fields`, `file_size`, `image_dimensions`, `title_length`, `description_length` |
4690
+ *
4691
+ * </details>
4692
+ *
4693
+ * <details>
4694
+ * <summary>Slug (<code>slug</code>)</summary>
4695
+ *
4696
+ * | Property | Value |
4697
+ * | ------------------------------ | ----------------------------------- |
4698
+ * | Code | `slug` |
4699
+ * | Built-in editors for the field | `slug` |
4700
+ * | Required validators | `slug_title_field` |
4701
+ * | Other validators available | `required`, `length`, `slug_format` |
4702
+ *
4703
+ * </details>
4704
+ *
4705
+ * <details>
4706
+ * <summary>External video (<code>video</code>)</summary>
4707
+ *
4708
+ * | Property | Value |
4709
+ * | ------------------------------ | ---------- |
4710
+ * | Code | `video` |
4711
+ * | Built-in editors for the field | `video` |
4712
+ * | Available validators | `required` |
4713
+ *
4714
+ * </details>
4715
+ *
4716
+ * <details>
4717
+ * <summary>Single-asset (<code>file</code>)</summary>
4718
+ *
4719
+ * | Property | Value |
4720
+ * | ------------------------------ | ------------------------------------------------------------------------------ |
4721
+ * | Code | `file` |
4722
+ * | Built-in editors for the field | `file` |
4723
+ * | Available validators | `required`, `file_size`, `image_dimensions`, `extension`, `required_alt_title` |
4724
+ *
4725
+ * </details>
4726
+ *
4727
+ * <details>
4728
+ * <summary>Asset gallery (<code>gallery</code>)</summary>
4729
+ *
4730
+ * | Property | Value |
4731
+ * | ------------------------------ | -------------------------------------------------------------------------- |
4732
+ * | Code | `gallery` |
4733
+ * | Built-in editors for the field | `gallery` |
4734
+ * | Available validators | `size`, `file_size`, `image_dimensions`, `extension`, `required_alt_title` |
4735
+ *
4736
+ * </details>
4737
+ *
4738
+ * <details>
4739
+ * <summary>Single link (<code>link</code>)</summary>
4740
+ *
4741
+ * | Property | Value |
4742
+ * | ------------------------------ | --------------------------- |
4743
+ * | Code | `link` |
4744
+ * | Built-in editors for the field | `link_select`, `link_embed` |
4745
+ * | Default `editor` | `link_select` |
4746
+ * | Required validators | `item_item_type` |
4747
+ * | Other validators available | `required`, `unique` |
4748
+ *
4749
+ * </details>
4750
+ *
4751
+ * <details>
4752
+ * <summary>Multiple links (<code>links</code>)</summary>
4753
+ *
4754
+ * | Property | Value |
4755
+ * | ------------------------------ | ----------------------------- |
4756
+ * | Code | `links` |
4757
+ * | Built-in editors for the field | `links_select`, `links_embed` |
4758
+ * | Default `editor` | `links_select` |
4759
+ * | Required validators | `items_item_type` |
4760
+ * | Other validators available | `size` |
4761
+ *
4762
+ * </details>
4763
+ *
4764
+ * <details>
4765
+ * <summary>Modular content (<code>rich_text</code>)</summary>
4766
+ *
4767
+ * | Property | Value |
4768
+ * | ------------------------------ | ------------------ |
4769
+ * | Code | `rich_text` |
4770
+ * | Built-in editors for the field | `rich_text` |
4771
+ * | Required validators | `rich_text_blocks` |
4772
+ * | Other validators available | `size` |
4773
+ *
4774
+ * </details>
4775
+ *
4776
+ * <details>
4777
+ * <summary>Structured text (<code>structured_text</code>)</summary>
4778
+ *
4779
+ * | Property | Value |
4780
+ * | ------------------------------ | ------------------------------------------------- |
4781
+ * | Code | `structured_text` |
4782
+ * | Built-in editors for the field | `structured_text` |
4783
+ * | Required validators | `structured_text_blocks`, `structured_text_links` |
4784
+ * | Other validators available | `length` |
4785
+ *
4786
+ * </details>
4787
+ *
4788
+ * ### Validators
4789
+ *
4790
+ * <details>
4791
+ * <summary><code>date_range</code></summary>
4792
+ *
4793
+ * Accept dates only inside a specified date range.
4794
+ *
4795
+ * | Parameter | Type | Required | Description |
4796
+ * | --------- | ------------- | -------- | ------------ |
4797
+ * | `min` | ISO 8601 date | | Minimum date |
4798
+ * | `max` | ISO 8601 date | | Maximum date |
4799
+ *
4800
+ * At least one of the parameters must be specified.
4801
+ *
4802
+ * </details>
4803
+ *
4804
+ * <details>
4805
+ * <summary><code>date_time_range</code></summary>
4806
+ *
4807
+ * Accept date times only inside a specified date range.
4808
+ *
4809
+ * | Parameter | Type | Required | Description |
4810
+ * | --------- | ----------------- | -------- | ---------------- |
4811
+ * | `min` | ISO 8601 datetime | | Minimum datetime |
4812
+ * | `max` | ISO 8601 datetime | | Maximum datetime |
4813
+ *
4814
+ * At least one of the parameters must be specified.
4815
+ *
4816
+ * </details>
4817
+ *
4818
+ * <details>
4819
+ * <summary><code>enum</code></summary>
4820
+ *
4821
+ * Only accept a specific set of values
4822
+ *
4823
+ * | Parameter | Type | Required | Description |
4824
+ * | --------- | --------------- | -------- | --------------------- |
4825
+ * | `values` | `Array<String>` | ✅ | Set of allowed values |
4826
+ *
4827
+ * </details>
4828
+ *
4829
+ * <details>
4830
+ * <summary><code>extension</code></summary>
4831
+ *
4832
+ * Only accept assets with specific file extensions.
4833
+ *
4834
+ * | Parameter | Type | Required | Description |
4835
+ * | ----------------- | ----------------------------------------- | -------- | ------------------------------ |
4836
+ * | `extensions` | `Array<String>` | | Set of allowed file extensions |
4837
+ * | `predefined_list` | one of `"image"`, `"transformable_image"`, `"video"`, `"document"` | | Allowed file type |
4838
+ *
4839
+ * Only one of the parameters must be specified.
4840
+ *
4841
+ * </details>
4842
+ *
4843
+ * <details>
4844
+ * <summary><code>file_size</code></summary>
4845
+ *
4846
+ * Accept assets only inside a specified date range.
4847
+ *
4848
+ * | Parameter | Type | Required | Description |
4849
+ * | ----------- | ---------------------------- | -------- | ---------------------------------- |
4850
+ * | `min_value` | `Integer` | | Numeric value for minimum filesize |
4851
+ * | `min_unit` | one of `"B"`, `"KB"`, `"MB"` | | Unit for minimum filesize |
4852
+ * | `max_value` | `Integer` | | Numeric value for maximum filesize |
4853
+ * | `max_unit` | one of `"B"`, `"KB"`, `"MB"` | | Unit for maximum filesize |
4854
+ *
4855
+ * At least one couple of value/unit must be specified.
4856
+ *
4857
+ * </details>
4858
+ *
4859
+ * <details>
4860
+ * <summary><code>format</code></summary>
4861
+ *
4862
+ * Only accept strings having a specific format.
4863
+ *
4864
+ * | Parameter | Type | Required | Description |
4865
+ * | -------------------- | ------------------------- | -------- | ---------------------------------- |
4866
+ * | `custom_pattern` | `Regexp` | | Regular expression to be validated |
4867
+ * | `predefined_pattern` | one of `"email"`, `"url"` | | Allowed format |
4868
+ *
4869
+ * Only one of the parameters must be specified.
4870
+ *
4871
+ * </details>
4872
+ *
4873
+ * <details>
4874
+ * <summary><code>slug_format</code></summary>
4875
+ *
4876
+ * Only accept slugs having a specific format.
4877
+ *
4878
+ * | Parameter | Type | Required | Description |
4879
+ * | -------------------- | ---------------- | -------- | ---------------------------------- |
4880
+ * | `custom_pattern` | `Regexp` | | Regular expression to be validated |
4881
+ * | `predefined_pattern` | `"webpage_slug"` | | Allowed format |
4882
+ *
4883
+ * Only one of the parameters must be specified.
4884
+ *
4885
+ * </details>
4886
+ *
4887
+ * <details>
4888
+ * <summary><code>image_dimensions</code></summary>
4889
+ *
4890
+ * Accept assets only within a specified height/width range.
4891
+ *
4892
+ * | Parameter | Type | Required | Description |
4893
+ * | ------------------ | --------- | -------- | -------------------------------- |
4894
+ * | `width_min_value` | `Integer` | | Numeric value for minimum width |
4895
+ * | `width_max_value` | `Integer` | | Numeric value for maximum height |
4896
+ * | `height_min_value` | `Integer` | | Numeric value for minimum width |
4897
+ * | `height_max_value` | `Integer` | | Numeric value for maximum height |
4898
+ *
4899
+ * At least one parameter must be specified.
4900
+ *
4901
+ * </details>
4902
+ *
4903
+ * <details>
4904
+ * <summary><code>item_item_type</code></summary>
4905
+ *
4906
+ * Only accept references to records of the specified models.
4907
+ *
4908
+ * | Parameter | Type | Required | Description |
4909
+ * | ------------------------------------------------- | ------------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------- |
4910
+ * | `item_types` | `Array<Model ID>` | ✅ | Set of allowed model IDs |
4911
+ * | `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 |
4912
+ * | `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 |
4913
+ * | `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 |
4914
+ *
4915
+ * Possible values for `on_publish_with_unpublished_references_strategy`:
4916
+ *
4917
+ * - `"fail"`: Fail the operation and notify the user
4918
+ * - `"publish_references"`: Publish also the referenced records
4919
+ *
4920
+ * Possible values for `on_reference_unpublish_strategy`:
4921
+ *
4922
+ * - `"fail"`: Fail the operation and notify the user
4923
+ * - `"unpublish"`: Unpublish also this record
4924
+ * - `"delete_references"`: Try to remove the reference to the unpublished record (if the field has a `required` validation it will fail)
4925
+ *
4926
+ * Possible values for `on_reference_delete_strategy`:
4927
+ *
4928
+ * - `"fail"`: Fail the operation and notify the user
4929
+ * - `"delete_references"`: Try to remove the reference to the deleted record (if the field has a `required` validation it will fail)
4930
+ * </details>
4931
+ *
4932
+ * <details>
4933
+ * <summary><code>items_item_type</code></summary>
4934
+ *
4935
+ * Only accept references to records of the specified models.
4936
+ *
4937
+ * | Parameter | Type | Required | Description |
4938
+ * | ------------------------------------------------- | ------------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------- |
4939
+ * | `item_types` | `Array<Model ID>` | ✅ | Set of allowed model IDs |
4940
+ * | `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 |
4941
+ * | `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 |
4942
+ * | `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 |
4943
+ *
4944
+ * Possible values for `on_publish_with_unpublished_references_strategy`:
4945
+ *
4946
+ * - `"fail"`: Fail the operation and notify the user
4947
+ * - `"publish_references"`: Publish also the referenced records
4948
+ *
4949
+ * Possible values for `on_reference_unpublish_strategy`:
4950
+ *
4951
+ * - `"fail"`: Fail the operation and notify the user
4952
+ * - `"unpublish"`: Unpublish also this record
4953
+ * - `"delete_references"`: Try to remove the reference to the unpublished record (if the field has a `required` validation it will fail)
4954
+ *
4955
+ * Possible values for `on_reference_delete_strategy`:
4956
+ *
4957
+ * - `"fail"`: Fail the operation and notify the user
4958
+ * - `"delete_references"`: Try to remove the reference to the deleted record (if the field has a `required` validation it will fail)
4959
+ * </details>
4960
+ *
4961
+ * <details>
4962
+ * <summary><code>length</code></summary>
4963
+ *
4964
+ * Accept strings only with a specified number of characters.
4965
+ *
4966
+ * | Parameter | Type | Required | Description |
4967
+ * | --------- | --------- | -------- | --------------- |
4968
+ * | `min` | `Integer` | | Minimum length |
4969
+ * | `eq` | `Integer` | | Expected length |
4970
+ * | `max` | `Integer` | | Maximum length |
4971
+ *
4972
+ * At least one parameter must be specified.
4973
+ *
4974
+ * </details>
4975
+ *
4976
+ * <details>
4977
+ * <summary><code>number_range</code></summary>
4978
+ *
4979
+ * Accept numbers only inside a specified range.
4980
+ *
4981
+ * | Parameter | Type | Required | Description |
4982
+ * | --------- | ------- | -------- | ------------- |
4983
+ * | `min` | `Float` | | Minimum value |
4984
+ * | `max` | `Float` | | Maximum value |
4985
+ *
4986
+ * At least one of the parameters must be specified.
4987
+ *
4988
+ * </details>
4989
+ *
4990
+ * <details>
4991
+ * <summary><code>required</code></summary>
4992
+ *
4993
+ * Value must be specified or it won't be valid.
4994
+ *
4995
+ * </details>
4996
+ *
4997
+ * <details>
4998
+ * <summary><code>required_alt_title</code></summary>
4999
+ *
5000
+ * Assets contained in the field are required to specify custom title or alternate text, or they won't be valid.
5001
+ *
5002
+ * | Parameter | Type | Required | Description |
5003
+ * | --------- | --------- | -------- | ---------------------------------------------------------- |
5004
+ * | `title` | `Boolean` | | Whether the title for the asset must be specified |
5005
+ * | `alt` | `Boolean` | | Whether the alternate text for the asset must be specified |
5006
+ *
5007
+ * At least one of the parameters must be specified.
5008
+ *
5009
+ * </details>
5010
+ *
5011
+ * <details>
5012
+ * <summary><code>required_seo_fields</code></summary>
5013
+ *
5014
+ * SEO field is to specify one or more properties, or it won't be valid.
5015
+ *
5016
+ * | Parameter | Type | Required | Description |
5017
+ * | -------------- | --------- | -------- | -------------------------------------------------- |
5018
+ * | `title` | `Boolean` | | Whether the meta title must be specified |
5019
+ * | `description` | `Boolean` | | Whether the meta description must be specified |
5020
+ * | `image` | `Boolean` | | Whether the social sharing image must be specified |
5021
+ * | `twitter_card` | `Boolean` | | Whether the type of Twitter card must be specified |
5022
+ *
5023
+ * At least one of the parameters must be specified.
5024
+ *
5025
+ * </details>
5026
+ *
5027
+ * <details>
5028
+ * <summary><code>title_length</code></summary>
5029
+ *
5030
+ * 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.
5031
+ *
5032
+ * | Parameter | Type | Required | Description |
5033
+ * | --------- | --------- | -------- | ------------- |
5034
+ * | `min` | `Integer` | | Minimum value |
5035
+ * | `max` | `Integer` | | Maximum value |
5036
+ *
5037
+ * At least one of the parameters must be specified.
5038
+ *
5039
+ * </details>
5040
+ *
5041
+ * <details>
5042
+ * <summary><code>description_length</code></summary>
5043
+ *
5044
+ * 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.
5045
+ *
5046
+ * | Parameter | Type | Required | Description |
5047
+ * | --------- | --------- | -------- | ------------- |
5048
+ * | `min` | `Integer` | | Minimum value |
5049
+ * | `max` | `Integer` | | Maximum value |
5050
+ *
5051
+ * At least one of the parameters must be specified.
5052
+ *
5053
+ * </details>
5054
+ *
5055
+ * <details>
5056
+ * <summary><code>rich_text_blocks</code></summary>
5057
+ *
5058
+ * Only accept references to block records of the specified block models.
5059
+ *
5060
+ * | Parameter | Type | Required | Description |
5061
+ * | ------------ | ----------------------- | -------- | ------------------------------ |
5062
+ * | `item_types` | `Array<Block Model ID>` | ✅ | Set of allowed Block Model IDs |
5063
+ *
5064
+ * </details>
5065
+ *
5066
+ * <details>
5067
+ * <summary><code>structured_text_blocks</code></summary>
5068
+ *
5069
+ * Only accept references to block records of the specified block models.
5070
+ *
5071
+ * | Parameter | Type | Required | Description |
5072
+ * | ------------ | ----------------------- | -------- | ------------------------------ |
5073
+ * | `item_types` | `Array<Block Model ID>` | ✅ | Set of allowed Block Model IDs |
5074
+ *
5075
+ * </details>
5076
+ *
5077
+ * <details>
5078
+ * <summary><code>structured_text_links</code></summary>
5079
+ *
5080
+ * Only accept `itemLink` to `inlineItem` nodes for records of the specified models.
5081
+ *
5082
+ * | Parameter | Type | Required | Description |
5083
+ * | ------------------------------------------------- | ------------------------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------- |
5084
+ * | `item_types` | `Array<Model ID>` | ✅ | Set of allowed model IDs |
5085
+ * | `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 |
5086
+ * | `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 |
5087
+ * | `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 |
5088
+ *
5089
+ * Possible values for `on_publish_with_unpublished_references_strategy`:
5090
+ *
5091
+ * - `"fail"`: Fail the operation and notify the user
5092
+ * - `"publish_references"`: Publish also the referenced records
5093
+ *
5094
+ * Possible values for `on_reference_unpublish_strategy`:
5095
+ *
5096
+ * - `"fail"`: Fail the operation and notify the user
5097
+ * - `"unpublish"`: Unpublish also this record
5098
+ * - `"delete_references"`: Try to remove the reference to the unpublished record (if the field has a `required` validation it will fail)
5099
+ *
5100
+ * Possible values for `on_reference_delete_strategy`:
5101
+ *
5102
+ * - `"fail"`: Fail the operation and notify the user
5103
+ * - `"delete_references"`: Try to remove the reference to the deleted record (if the field has a `required` validation it will fail)
5104
+ * </details>
5105
+ *
5106
+ * <details>
5107
+ * <summary><code>size</code></summary>
5108
+ *
5109
+ * Only accept a number of items within the specified range.
5110
+ *
5111
+ * | Parameter | Type | Required | Description |
5112
+ * | ------------- | --------- | -------- | -------------------------------------------------- |
5113
+ * | `min` | `Integer` | | Minimum length |
5114
+ * | `eq` | `Integer` | | Expected length |
5115
+ * | `max` | `Integer` | | Maximum length |
5116
+ * | `multiple_of` | `Integer` | | The number of items must be multiple of this value |
5117
+ *
5118
+ * At least one parameter must be specified.
5119
+ *
5120
+ * </details>
5121
+ *
5122
+ * <details>
5123
+ * <summary><code>slug_title_field</code></summary>
5124
+ *
5125
+ * Specifies the ID of the _Single-line string_ field that will be used to generate the slug
5126
+ *
5127
+ * | Parameter | Type | Required | Description |
5128
+ * | ---------------- | ---------- | -------- | ------------------------------------------------ |
5129
+ * | `title_field_id` | `Field ID` | ✅ | The field that will be used to generate the slug |
5130
+ *
5131
+ * </details>
5132
+ *
5133
+ * <details>
5134
+ * <summary><code>unique</code></summary>
5135
+ *
5136
+ * The value must be unique across the whole collection of records.
5137
+ *
5138
+ * </details>
5139
+ *
5140
+ * ### Configuration parameters for DatoCMS built-in field editors
5141
+ *
5142
+ * If a field editor is not specified in this table, just pass an empty object `{}` as its configuration parameters.
5143
+ *
5144
+ * <details>
5145
+ * <summary><code>boolean_radio_group</code></summary>
5146
+ *
5147
+ * Radio group input for _boolean_ fields.
5148
+ *
5149
+ * | Parameter | Type | Required | Description |
5150
+ * | ---------------- | ---------------------------------- | -------- | ----------------------------------------- |
5151
+ * | `positive_radio` | `{ label: string, hint?: string }` | ✅ | Radio input for positive choice (`true`) |
5152
+ * | `negative_radio` | `{ label: string, hint?: string }` | ✅ | Radio input for negative choice (`false`) |
5153
+ *
5154
+ * </details>
5155
+ *
5156
+ * <details>
5157
+ * <summary><code>string_radio_group</code></summary>
5158
+ *
5159
+ * Radio group input for _string_ fields.
5160
+ *
5161
+ * | Parameter | Type | Required | Description |
5162
+ * | --------- | -------------------------------------------------------- | -------- | --------------------------- |
5163
+ * | `radios` | `Array<{ label: string, value: string, hint?: string }>` | ✅ | The different radio options |
5164
+ *
5165
+ * </details>
5166
+ *
5167
+ * <details>
5168
+ * <summary><code>string_select</code></summary>
5169
+ *
5170
+ * Select input for _string_ fields.
5171
+ *
5172
+ * | Parameter | Type | Required | Description |
5173
+ * | --------- | -------------------------------------------------------- | -------- | ---------------------------- |
5174
+ * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅ | The different select options |
5175
+ *
5176
+ * </details>
5177
+ *
5178
+ * <details>
5179
+ * <summary><code>string_multi_select</code></summary>
5180
+ *
5181
+ * Select input for _JSON_ fields, to edit an array of strings.
5182
+ *
5183
+ * | Parameter | Type | Required | Description |
5184
+ * | --------- | -------------------------------------------------------- | -------- | ---------------------------- |
5185
+ * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅ | The different select options |
5186
+ *
5187
+ * </details>
5188
+ *
5189
+ * <details>
5190
+ * <summary><code>string_checkbox_group</code></summary>
5191
+ *
5192
+ * Multiple chechboxes input for _JSON_ fields, to edit an array of strings.
5193
+ *
5194
+ * | Parameter | Type | Required | Description |
5195
+ * | --------- | -------------------------------------------------------- | -------- | ---------------------------- |
5196
+ * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅ | The different select options |
5197
+ *
5198
+ * </details>
5199
+ *
5200
+ * <details>
5201
+ * <summary><code>single_line</code></summary>
5202
+ *
5203
+ * Simple textual input for _Single-line string_ fields.
5204
+ *
5205
+ * | Parameter | Type | Required | Description |
5206
+ * | --------- | --------- | -------- | -------------------------------------------------------------------------------- |
5207
+ * | `heading` | `Boolean` | ✅ | Indicates if the field should be shown bigger, as a field representing a heading |
5208
+ *
5209
+ * </details>
5210
+ *
5211
+ * <details>
5212
+ * <summary><code>markdown</code></summary>
5213
+ *
5214
+ * Markdown editor for _Multiple-paragraph text_ fields.
5215
+ *
5216
+ * | Parameter | Type | Required | Description |
5217
+ * | --------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
5218
+ * | `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"` |
5219
+ *
5220
+ * </details>
5221
+ *
5222
+ * <details>
5223
+ * <summary><code>wysiwyg</code></summary>
5224
+ *
5225
+ * HTML editor for _Multiple-paragraph text_ fields.
5226
+ *
5227
+ * | Parameter | Type | Required | Description |
5228
+ * | --------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
5229
+ * | `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"` |
5230
+ *
5231
+ * </details>
5232
+ *
5233
+ * <details>
5234
+ * <summary><code>textarea</code></summary>
5235
+ *
5236
+ * Basic textarea editor for _Multiple-paragraph text_ fields.
5237
+ *
5238
+ * </details>
5239
+ *
5240
+ * <details>
5241
+ * <summary><code>color_picker</code></summary>
5242
+ *
5243
+ * Built-in editor for _Color_ fields.
5244
+ *
5245
+ * | Parameter | Type | Required | Description |
5246
+ * | --------------- | ------------------------- | -------- | --------------------------------------------------------- |
5247
+ * | `enable_alpha` | `Boolean` | ✅ | Should the color picker allow to specify the alpha value? |
5248
+ * | `preset_colors` | `Array<Hex color string>` | ✅ | List of preset colors to offer to the user |
5249
+ *
5250
+ * </details>
5251
+ *
5252
+ * <details>
5253
+ * <summary><code>slug</code></summary>
5254
+ *
5255
+ * Built-in editor for _Slug_ fields.
5256
+ *
5257
+ * | Parameter | Type | Required | Description |
5258
+ * | ------------ | -------- | -------- | -------------------------------------------------------------------------------------- |
5259
+ * | `url_prefix` | `String` | | A prefix that will be shown in the editor's form to give some context to your editors. |
5260
+ *
5261
+ * </details>
5262
+ *
5263
+ * <details>
5264
+ * <summary><code>rich_text</code></summary>
5265
+ *
5266
+ * Built-in editor for _Modular content_ fields.
4195
5267
  *
4196
- * This interface was referenced by `Item`'s JSON-Schema
4197
- * via the `bulk_destroy.targetSchema` link.
5268
+ * | Parameter | Type | Required | Description |
5269
+ * | ----------------- | --------- | -------- | ---------------------------------------------------------- |
5270
+ * | `start_collapsed` | `Boolean` | | Whether you want block records collapsed by default or not |
4198
5271
  *
4199
- * This interface was referenced by `Item`'s JSON-Schema
4200
- * via the `bulk_move_to_stage.targetSchema` link.
5272
+ * </details>
4201
5273
  *
4202
- * This interface was referenced by `ItemVersion`'s JSON-Schema
4203
- * via the `restore.targetSchema` link.
5274
+ * <details>
5275
+ * <summary><code>structured_text</code></summary>
4204
5276
  *
4205
- * This interface was referenced by `Upload`'s JSON-Schema
4206
- * via the `create.targetSchema` link.
5277
+ * Built-in editor for _Structured text_ fields.
4207
5278
  *
4208
- * This interface was referenced by `Upload`'s JSON-Schema
4209
- * via the `update.targetSchema` link.
5279
+ * | Parameter | Type | Required | Description |
5280
+ * | ------------------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
5281
+ * | `nodes` | `Array<String>` | ✅ | Specify which nodes the field should allow. Valid values: `"blockquote"`, `"code"`, `"heading"`, `"link"`, `"list"`, `"thematicBreak"` |
5282
+ * | `marks` | `Array<String>` | ✅ | Specify which marks the field should allow. Valid values: `"strong"`, `"emphasis"`, `"underline"`, `"strikethrough"`, `"code"`, `"highlight"` |
5283
+ * | `blocks_start_collapsed` | `Boolean` | | Whether you want block nodes collapsed by default or not |
5284
+ * | `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 |
5285
+ * | `show_links_meta_editor` | `Boolean` | | Whether you want to show the complete meta editor for links |
4210
5286
  *
4211
- * This interface was referenced by `Upload`'s JSON-Schema
4212
- * via the `batch_add_tags.targetSchema` link.
5287
+ * </details>
4213
5288
  *
4214
- * This interface was referenced by `Upload`'s JSON-Schema
4215
- * via the `batch_destroy.targetSchema` link.
5289
+ * <details>
5290
+ * <summary><code>link_select</code> and <code>links_select</code></summary>
4216
5291
  *
4217
- * This interface was referenced by `Upload`'s JSON-Schema
4218
- * via the `bulk_tag.targetSchema` link.
5292
+ * Use a select input with auto-completion to pick the records to reference inside the field.
4219
5293
  *
4220
- * This interface was referenced by `Upload`'s JSON-Schema
4221
- * via the `bulk_destroy.targetSchema` link.
5294
+ * </details>
4222
5295
  *
4223
- * This interface was referenced by `Site`'s JSON-Schema
4224
- * via the `update.targetSchema` link.
5296
+ * <details>
5297
+ * <summary><code>link_embed</code> and <code>links_embed</code></summary>
4225
5298
  *
4226
- * This interface was referenced by `DatoApi`'s JSON-Schema
4227
- * via the `definition` "job".
4228
- */
4229
- export type Job = {
4230
- id: JobIdentity;
4231
- type: JobType;
4232
- };
4233
- export type ItemTypeUpdateTargetSchema = Job;
4234
- export type ItemTypeDestroyTargetSchema = Job;
4235
- export type FieldCreateTargetSchema = Job;
4236
- export type FieldUpdateTargetSchema = Job;
4237
- export type FieldDestroyTargetSchema = Job;
4238
- export type FieldDuplicateTargetSchema = Job;
4239
- export type ItemDuplicateTargetSchema = Job;
4240
- export type ItemDestroyTargetSchema = Job;
4241
- export type ItemBatchDestroyTargetSchema = Job;
4242
- export type ItemBatchPublishTargetSchema = Job;
4243
- export type ItemBatchUnpublishTargetSchema = Job;
4244
- export type ItemBulkPublishTargetSchema = Job;
4245
- export type ItemBulkUnpublishTargetSchema = Job;
4246
- export type ItemBulkDestroyTargetSchema = Job;
4247
- export type ItemBulkMoveToStageTargetSchema = Job;
4248
- export type ItemVersionRestoreTargetSchema = Job;
4249
- export type UploadCreateTargetSchema = Job;
4250
- export type UploadUpdateTargetSchema = Job;
4251
- export type UploadBatchAddTagsTargetSchema = Job;
4252
- export type UploadBatchDestroyTargetSchema = Job;
4253
- export type UploadBulkTagTargetSchema = Job;
4254
- export type UploadBulkDestroyTargetSchema = Job;
4255
- export type SiteUpdateTargetSchema = Job;
4256
- /**
4257
- * JSON API data
5299
+ * Use an expanded view with records' image preview to pick the records to reference inside the field.
5300
+ *
5301
+ * </details>
4258
5302
  *
4259
- * This interface was referenced by `Job`'s JSON-Schema
4260
- * via the `definition` "data".
4261
- */
4262
- export type JobData = {
4263
- type: JobType;
4264
- id: JobIdentity;
4265
- };
4266
-
4267
- /**
4268
- * 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.
4269
5303
  *
4270
5304
  * This interface was referenced by `DatoApi`'s JSON-Schema
4271
5305
  * via the `definition` "field".
@@ -4369,17 +5403,6 @@ export type FieldUpdateJobSchema = Field;
4369
5403
  export type FieldSelfTargetSchema = Field;
4370
5404
  export type FieldDestroyJobSchema = Field;
4371
5405
  export type FieldDuplicateJobSchema = Field;
4372
- /**
4373
- * JSON API data
4374
- *
4375
- * This interface was referenced by `Fieldset`'s JSON-Schema
4376
- * via the `definition` "data".
4377
- */
4378
- export type FieldsetData = {
4379
- type: FieldsetType;
4380
- id: FieldsetIdentity;
4381
- };
4382
-
4383
5406
  /**
4384
5407
  * JSON API attributes
4385
5408
  *
@@ -4870,145 +5893,6 @@ export type SessionCreateSchema = {
4870
5893
  otp_code?: string;
4871
5894
  };
4872
5895
 
4873
- /**
4874
- * An API token allows access to our API. It is linked to a Role, which describes what actions can be performed.
4875
- *
4876
- * This interface was referenced by `DatoApi`'s JSON-Schema
4877
- * via the `definition` "access_token".
4878
- */
4879
- export type AccessToken = {
4880
- id: AccessTokenIdentity;
4881
- type: AccessTokenType;
4882
- /**
4883
- * Name of API token
4884
- */
4885
- name: string;
4886
- /**
4887
- * The actual API token
4888
- */
4889
- token?: string;
4890
- /**
4891
- * Whether this API token can access the Content Delivery API published content endpoint
4892
- */
4893
- can_access_cda: boolean;
4894
- /**
4895
- * Whether this API token can access the Content Delivery API draft content endpoint
4896
- */
4897
- can_access_cda_preview: boolean;
4898
- /**
4899
- * Whether this API token can access the Content Management API
4900
- */
4901
- can_access_cma: boolean;
4902
- hardcoded_type: null | string;
4903
- role: RoleData | null;
4904
- };
4905
- export type AccessTokenCreateTargetSchema = AccessToken;
4906
- export type AccessTokenUpdateTargetSchema = AccessToken;
4907
- export type AccessTokenSelfTargetSchema = AccessToken;
4908
- export type AccessTokenRegenerateTokenTargetSchema = AccessToken;
4909
- export type AccessTokenDestroyTargetSchema = AccessToken;
4910
- /**
4911
- * JSON API data
4912
- *
4913
- * This interface was referenced by `AccessToken`'s JSON-Schema
4914
- * via the `definition` "data".
4915
- */
4916
- export type AccessTokenData = {
4917
- type: AccessTokenType;
4918
- id: AccessTokenIdentity;
4919
- };
4920
-
4921
- /**
4922
- * JSON API attributes
4923
- *
4924
- * This interface was referenced by `AccessToken`'s JSON-Schema
4925
- * via the `definition` "attributes".
4926
- */
4927
- export type AccessTokenAttributes = {
4928
- /**
4929
- * Name of API token
4930
- */
4931
- name: string;
4932
- /**
4933
- * The actual API token
4934
- */
4935
- token?: string;
4936
- /**
4937
- * Whether this API token can access the Content Delivery API published content endpoint
4938
- */
4939
- can_access_cda: boolean;
4940
- /**
4941
- * Whether this API token can access the Content Delivery API draft content endpoint
4942
- */
4943
- can_access_cda_preview: boolean;
4944
- /**
4945
- * Whether this API token can access the Content Management API
4946
- */
4947
- can_access_cma: boolean;
4948
- hardcoded_type: null | string;
4949
- };
4950
-
4951
- /**
4952
- * JSON API links
4953
- *
4954
- * This interface was referenced by `AccessToken`'s JSON-Schema
4955
- * via the `definition` "relationships".
4956
- */
4957
- export type AccessTokenRelationships = {
4958
- role: RoleData | null;
4959
- };
4960
-
4961
- /**
4962
- * This interface was referenced by `AccessToken`'s JSON-Schema
4963
- * via the `create.schema` link.
4964
- */
4965
- export type AccessTokenCreateSchema = {
4966
- type?: AccessTokenType;
4967
- /**
4968
- * Name of API token
4969
- */
4970
- name: string;
4971
- /**
4972
- * Whether this API token can access the Content Delivery API published content endpoint
4973
- */
4974
- can_access_cda: boolean;
4975
- /**
4976
- * Whether this API token can access the Content Delivery API draft content endpoint
4977
- */
4978
- can_access_cda_preview: boolean;
4979
- /**
4980
- * Whether this API token can access the Content Management API
4981
- */
4982
- can_access_cma: boolean;
4983
- role: RoleData | null;
4984
- };
4985
-
4986
- /**
4987
- * This interface was referenced by `AccessToken`'s JSON-Schema
4988
- * via the `update.schema` link.
4989
- */
4990
- export type AccessTokenUpdateSchema = {
4991
- id?: AccessTokenIdentity;
4992
- type?: AccessTokenType;
4993
- /**
4994
- * Name of API token
4995
- */
4996
- name: string;
4997
- /**
4998
- * Whether this API token can access the Content Delivery API published content endpoint
4999
- */
5000
- can_access_cda: boolean;
5001
- /**
5002
- * Whether this API token can access the Content Delivery API draft content endpoint
5003
- */
5004
- can_access_cda_preview: boolean;
5005
- /**
5006
- * Whether this API token can access the Content Management API
5007
- */
5008
- can_access_cma: boolean;
5009
- role: RoleData | null;
5010
- };
5011
-
5012
5896
  /**
5013
5897
  * Plugins enable developers to replace DatoCMS field components with HTML5 applications so the editing experiences of the DatoCMS web app can be customized.
5014
5898
  *
@@ -6730,6 +7614,10 @@ export type EnvironmentMeta = {
6730
7614
  * Is this environment the primary for the project?
6731
7615
  */
6732
7616
  primary: boolean;
7617
+ /**
7618
+ * ID of the environment that's been forked to generate this one
7619
+ */
7620
+ forked_from?: string | null;
6733
7621
  };
6734
7622
 
6735
7623
  /**
@@ -8364,10 +9252,6 @@ export type Site = {
8364
9252
  * Specifies the last time when a change of data occurred
8365
9253
  */
8366
9254
  last_data_change_at: null | string;
8367
- /**
8368
- * Frontend website url
8369
- */
8370
- frontend_url: string | null;
8371
9255
  /**
8372
9256
  * Specifies whether all users of this site need to authenticate using two-factor authentication
8373
9257
  */
@@ -8451,36 +9335,27 @@ export type Site = {
8451
9335
  } | null;
8452
9336
  account: AccountData;
8453
9337
  /**
8454
- * The list of build trigger
8455
- */
8456
- build_triggers?: BuildTriggerData[];
8457
- /**
8458
- * The list of site menu items
8459
- */
8460
- menu_items: MenuItemData[];
8461
- /**
8462
- * The list of site SSO users
8463
- */
8464
- sso_users: SsoUserData[];
8465
- /**
8466
- * The list of site users
8467
- */
8468
- users: UserData[];
8469
- /**
8470
- * The list of site item types
9338
+ * The list item types for the site
8471
9339
  */
8472
9340
  item_types: ItemTypeData[];
8473
- /**
8474
- * Specifies the default role for newly created identity providers users
8475
- */
8476
- sso_default_role?: RoleData[];
8477
- /**
8478
- * The list of site roles
8479
- */
8480
- roles: RoleData[];
9341
+ meta: SiteMeta;
8481
9342
  };
8482
9343
  export type SiteSelfTargetSchema = Site;
8483
9344
  export type SiteUpdateJobSchema = Site;
9345
+ export type SiteActivateImprovedTimezoneManagementJobSchema = Site;
9346
+ /**
9347
+ * Meta attributes
9348
+ *
9349
+ * This interface was referenced by `Site`'s JSON-Schema
9350
+ * via the `definition` "meta".
9351
+ */
9352
+ export type SiteMeta = {
9353
+ /**
9354
+ * Whether the Improved API Timezone Management option is active or not
9355
+ */
9356
+ improved_timezone_management: boolean;
9357
+ };
9358
+
8484
9359
  /**
8485
9360
  * JSON API data
8486
9361
  *
@@ -8539,10 +9414,6 @@ export type SiteAttributes = {
8539
9414
  * Specifies the last time when a change of data occurred
8540
9415
  */
8541
9416
  last_data_change_at: null | string;
8542
- /**
8543
- * Frontend website url
8544
- */
8545
- frontend_url: string | null;
8546
9417
  /**
8547
9418
  * Specifies whether all users of this site need to authenticate using two-factor authentication
8548
9419
  */
@@ -8635,33 +9506,9 @@ export type SiteAttributes = {
8635
9506
  export type SiteRelationships = {
8636
9507
  account: AccountData;
8637
9508
  /**
8638
- * The list of build trigger
8639
- */
8640
- build_triggers?: BuildTriggerData[];
8641
- /**
8642
- * The list of site menu items
8643
- */
8644
- menu_items: MenuItemData[];
8645
- /**
8646
- * The list of site SSO users
8647
- */
8648
- sso_users: SsoUserData[];
8649
- /**
8650
- * The list of site users
8651
- */
8652
- users: UserData[];
8653
- /**
8654
- * The list of site item types
9509
+ * The list item types for the site
8655
9510
  */
8656
9511
  item_types: ItemTypeData[];
8657
- /**
8658
- * Specifies the default role for newly created identity providers users
8659
- */
8660
- sso_default_role?: RoleData[];
8661
- /**
8662
- * The list of site roles
8663
- */
8664
- roles: RoleData[];
8665
9512
  };
8666
9513
 
8667
9514
  /**
@@ -8773,6 +9620,12 @@ export type SiteUpdateSchema = {
8773
9620
  */
8774
9621
  ip_tracking_enabled?: boolean;
8775
9622
  sso_default_role?: RoleData;
9623
+ meta?: {
9624
+ /**
9625
+ * Whether the Improved API Timezone Management option is active or not
9626
+ */
9627
+ improved_timezone_management?: boolean;
9628
+ };
8776
9629
  };
8777
9630
 
8778
9631
  /**