@datocms/cma-client 1.3.5 → 2.0.0-alpha.0

package/resources.json

@@ -10,6 +10,7 @@
         "method": "POST",
         "comment": "Create a new role",
         "requestBodyType": "RoleCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "role",
           "attributes": [
@@ -61,8 +62,10 @@
           "relType": "RoleData"
         },
         "requestBodyType": "RoleUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "role",
+          "idRequired": true,
           "attributes": [
             "name",
             "can_edit_favicon",
@@ -106,6 +109,7 @@
         "urlTemplate": "/roles",
         "method": "GET",
         "comment": "List all roles",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "RoleInstancesTargetSchema",
         "name": "list",
@@ -123,6 +127,7 @@
           "isEntityId": true,
           "relType": "RoleData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "RoleSelfTargetSchema",
         "name": "find",
@@ -140,6 +145,7 @@
           "isEntityId": true,
           "relType": "RoleData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "RoleDestroyTargetSchema",
         "name": "destroy",
@@ -165,8 +171,10 @@
           "relType": "UserData"
         },
         "requestBodyType": "UserUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "user",
+          "idRequired": true,
           "attributes": [
             "is_active"
           ],
@@ -186,6 +194,7 @@
         "urlTemplate": "/users",
         "method": "GET",
         "comment": "List all collaborators",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "UserInstancesTargetSchema",
         "name": "list",
@@ -203,6 +212,7 @@
           "isEntityId": true,
           "relType": "UserData"
         },
+        "optionalRequestBody": false,
         "queryParamsType": "UserSelfHrefSchema",
         "queryParamsRequired": false,
         "responseType": "UserSelfTargetSchema",
@@ -216,6 +226,7 @@
         "urlTemplate": "/users/me",
         "method": "GET",
         "comment": "Retrieve current signed-in user",
+        "optionalRequestBody": false,
         "queryParamsType": "UserMeHrefSchema",
         "queryParamsRequired": false,
         "responseType": "UserMeTargetSchema",
@@ -234,6 +245,7 @@
           "isEntityId": true,
           "relType": "UserData"
         },
+        "optionalRequestBody": false,
         "queryParamsType": "UserDestroyHrefSchema",
         "queryParamsRequired": false,
         "responseType": "UserDestroyTargetSchema",
@@ -254,6 +266,7 @@
         "urlTemplate": "/sso-users",
         "method": "GET",
         "comment": "List all users",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SsoUserInstancesTargetSchema",
         "name": "list",
@@ -271,6 +284,7 @@
           "isEntityId": false,
           "relType": "UserData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SsoUserSelfTargetSchema",
         "name": "find",
@@ -283,6 +297,7 @@
         "urlTemplate": "/sso-users/copy-users",
         "method": "POST",
         "comment": "Copy editors as SSO users",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SsoUserCopyUsersTargetSchema",
         "name": "copyUsers",
@@ -300,6 +315,7 @@
           "isEntityId": false,
           "relType": "UserData"
         },
+        "optionalRequestBody": false,
         "queryParamsType": "SsoUserDestroyHrefSchema",
         "queryParamsRequired": false,
         "responseType": "SsoUserDestroyTargetSchema",
@@ -321,6 +337,7 @@
         "method": "POST",
         "comment": "List Audit Log events",
         "requestBodyType": "AuditLogEventQuerySchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "audit_log_query",
           "attributes": [
@@ -350,6 +367,7 @@
         "method": "POST",
         "comment": "Create a new menu item",
         "requestBodyType": "MenuItemCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "menu_item",
           "attributes": [
@@ -382,8 +400,10 @@
           "relType": "MenuItemData"
         },
         "requestBodyType": "MenuItemUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "menu_item",
+          "idRequired": true,
           "attributes": [
             "label",
             "external_url",
@@ -408,6 +428,7 @@
         "urlTemplate": "/menu-items",
         "method": "GET",
         "comment": "List all menu items",
+        "optionalRequestBody": false,
         "queryParamsType": "MenuItemInstancesHrefSchema",
         "queryParamsRequired": false,
         "responseType": "MenuItemInstancesTargetSchema",
@@ -426,6 +447,7 @@
           "isEntityId": true,
           "relType": "MenuItemData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "MenuItemSelfTargetSchema",
         "name": "find",
@@ -443,6 +465,7 @@
           "isEntityId": true,
           "relType": "MenuItemData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "MenuItemDestroyTargetSchema",
         "name": "destroy",
@@ -463,6 +486,7 @@
         "method": "POST",
         "comment": "Create a new model",
         "requestBodyType": "ItemTypeCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item_type",
           "attributes": [
@@ -508,8 +532,10 @@
           "relType": "ItemTypeData"
         },
         "requestBodyType": "ItemTypeUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item_type",
+          "idRequired": true,
           "attributes": [
             "name",
             "api_key",
@@ -547,6 +573,7 @@
         "urlTemplate": "/item-types",
         "method": "GET",
         "comment": "List all models",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ItemTypeInstancesTargetSchema",
         "name": "list",
@@ -564,6 +591,7 @@
           "isEntityId": true,
           "relType": "ItemTypeData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ItemTypeSelfTargetSchema",
         "name": "find",
@@ -581,6 +609,7 @@
           "isEntityId": true,
           "relType": "ItemTypeData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ItemTypeDuplicateTargetSchema",
         "name": "duplicate",
@@ -598,6 +627,7 @@
           "isEntityId": true,
           "relType": "ItemTypeData"
         },
+        "optionalRequestBody": false,
         "queryParamsType": "ItemTypeDestroyHrefSchema",
         "queryParamsRequired": false,
         "responseType": "ItemTypeDestroyJobSchema",
@@ -624,6 +654,7 @@
           "relType": "ItemTypeData"
         },
         "requestBodyType": "FieldCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "field",
           "attributes": [
@@ -660,8 +691,10 @@
           "relType": "FieldData"
         },
         "requestBodyType": "FieldUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "field",
+          "idRequired": true,
           "attributes": [
             "default_value",
             "label",
@@ -695,6 +728,7 @@
           "isEntityId": false,
           "relType": "ItemTypeData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "FieldInstancesTargetSchema",
         "name": "list",
@@ -712,6 +746,7 @@
           "isEntityId": false,
           "relType": "ItemTypeData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "FieldReferencingTargetSchema",
         "deprecated": "This API call is to be considered private and might change without notice",
@@ -730,6 +765,7 @@
           "isEntityId": false,
           "relType": "ItemTypeData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "FieldRelatedTargetSchema",
         "deprecated": "This API call is to be considered private and might change without notice",
@@ -748,6 +784,7 @@
           "isEntityId": true,
           "relType": "FieldData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "FieldSelfTargetSchema",
         "name": "find",
@@ -765,6 +802,7 @@
           "isEntityId": true,
           "relType": "FieldData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "FieldDestroyJobSchema",
         "name": "destroy",
@@ -782,6 +820,7 @@
           "isEntityId": true,
           "relType": "FieldData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "FieldDuplicateJobSchema",
         "name": "duplicate",
@@ -807,6 +846,7 @@
           "relType": "ItemTypeData"
         },
         "requestBodyType": "FieldsetCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "fieldset",
           "attributes": [
@@ -836,8 +876,10 @@
           "relType": "FieldsetData"
         },
         "requestBodyType": "FieldsetUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "fieldset",
+          "idRequired": true,
           "attributes": [
             "title",
             "hint",
@@ -864,6 +906,7 @@
           "isEntityId": false,
           "relType": "ItemTypeData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "FieldsetInstancesTargetSchema",
         "name": "list",
@@ -881,6 +924,7 @@
           "isEntityId": true,
           "relType": "FieldsetData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "FieldsetSelfTargetSchema",
         "name": "find",
@@ -898,6 +942,7 @@
           "isEntityId": true,
           "relType": "FieldsetData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "FieldsetDestroyTargetSchema",
         "name": "destroy",
@@ -918,6 +963,7 @@
         "method": "POST",
         "comment": "Create a new session",
         "requestBodyType": "SessionCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "email_credentials",
           "attributes": [
@@ -948,6 +994,7 @@
         "method": "POST",
         "comment": "Create a new API token",
         "requestBodyType": "AccessTokenCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "access_token",
           "attributes": [
@@ -978,8 +1025,10 @@
           "relType": "AccessTokenData"
         },
         "requestBodyType": "AccessTokenUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "access_token",
+          "idRequired": true,
           "attributes": [
             "name",
             "can_access_cda",
@@ -1002,6 +1051,7 @@
         "urlTemplate": "/access_tokens",
         "method": "GET",
         "comment": "List all API tokens",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "AccessTokenInstancesTargetSchema",
         "name": "list",
@@ -1019,6 +1069,7 @@
           "isEntityId": true,
           "relType": "AccessTokenData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "AccessTokenSelfTargetSchema",
         "name": "find",
@@ -1036,6 +1087,7 @@
           "isEntityId": true,
           "relType": "AccessTokenData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "AccessTokenRegenerateTokenTargetSchema",
         "name": "regenerateToken",
@@ -1053,6 +1105,7 @@
           "isEntityId": true,
           "relType": "AccessTokenData"
         },
+        "optionalRequestBody": false,
         "queryParamsType": "AccessTokenDestroyHrefSchema",
         "queryParamsRequired": false,
         "responseType": "AccessTokenDestroyTargetSchema",
@@ -1074,6 +1127,7 @@
         "method": "POST",
         "comment": "Create a new plugin",
         "requestBodyType": "PluginCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "plugin",
           "attributes": [
@@ -1107,8 +1161,10 @@
           "relType": "PluginData"
         },
         "requestBodyType": "PluginUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "plugin",
+          "idRequired": true,
           "attributes": [
             "name",
             "description",
@@ -1131,6 +1187,7 @@
         "urlTemplate": "/plugins",
         "method": "GET",
         "comment": "List all plugins",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "PluginInstancesTargetSchema",
         "name": "list",
@@ -1142,12 +1199,13 @@
         "rel": "self",
         "urlTemplate": "/plugins/${pluginId}",
         "method": "GET",
-        "comment": "Retrieve a plugins",
+        "comment": "Retrieve a plugin",
         "urlPlaceholder": {
           "variableName": "pluginId",
           "isEntityId": true,
           "relType": "PluginData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "PluginSelfTargetSchema",
         "name": "find",
@@ -1165,6 +1223,7 @@
           "isEntityId": true,
           "relType": "PluginData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "PluginDestroyTargetSchema",
         "name": "destroy",
@@ -1182,6 +1241,7 @@
           "isEntityId": true,
           "relType": "PluginData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "PluginFieldsTargetSchema",
         "name": "fields",
@@ -1206,6 +1266,7 @@
           "isEntityId": true,
           "relType": "JobResultData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "JobResultSelfTargetSchema",
         "name": "find",
@@ -1225,6 +1286,7 @@
         "urlTemplate": "/subscription-limits",
         "method": "GET",
         "comment": "Get all the subscription limits",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SubscriptionLimitInstancesTargetSchema",
         "name": "list",
@@ -1242,6 +1304,7 @@
           "isEntityId": true,
           "relType": "SubscriptionLimitData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SubscriptionLimitSelfTargetSchema",
         "name": "find",
@@ -1261,6 +1324,7 @@
         "urlTemplate": "/subscription-features",
         "method": "GET",
         "comment": "Get all the subscription features",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SubscriptionFeatureInstancesTargetSchema",
         "name": "list",
@@ -1280,6 +1344,7 @@
         "urlTemplate": "/build-events",
         "method": "GET",
         "comment": "List all deploy events",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "BuildEventInstancesTargetSchema",
         "name": "list",
@@ -1297,6 +1362,7 @@
           "isEntityId": true,
           "relType": "BuildEventData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "BuildEventSelfTargetSchema",
         "name": "find",
@@ -1316,6 +1382,7 @@
         "urlTemplate": "/items",
         "method": "GET",
         "comment": "List all records",
+        "optionalRequestBody": false,
         "queryParamsType": "ItemInstancesHrefSchema",
         "queryParamsRequired": false,
         "responseType": "ItemInstancesTargetSchema",
@@ -1339,8 +1406,10 @@
           "relType": "ItemData"
         },
         "requestBodyType": "ItemValidateExistingSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item",
+          "idRequired": true,
           "attributes": "*",
           "relationships": [
             "item_type",
@@ -1360,6 +1429,7 @@
         "method": "POST",
         "comment": "Validates a record field",
         "requestBodyType": "ItemValidateNewSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item",
           "attributes": "*",
@@ -1381,6 +1451,7 @@
         "method": "POST",
         "comment": "Create a new record",
         "requestBodyType": "ItemCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item",
           "attributes": "*",
@@ -1406,6 +1477,7 @@
           "isEntityId": true,
           "relType": "ItemData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ItemDuplicateJobSchema",
         "name": "duplicate",
@@ -1424,8 +1496,10 @@
           "relType": "ItemData"
         },
         "requestBodyType": "ItemUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item",
+          "idRequired": true,
           "attributes": "*",
           "relationships": [
             "item_type",
@@ -1449,6 +1523,7 @@
           "isEntityId": true,
           "relType": "ItemData"
         },
+        "optionalRequestBody": false,
         "queryParamsType": "ItemReferencesHrefSchema",
         "queryParamsRequired": false,
         "responseType": "ItemReferencesTargetSchema",
@@ -1467,12 +1542,32 @@
           "isEntityId": true,
           "relType": "ItemData"
         },
+        "optionalRequestBody": false,
         "queryParamsType": "ItemSelfHrefSchema",
         "queryParamsRequired": false,
         "responseType": "ItemSelfTargetSchema",
         "name": "find",
         "rawName": "rawFind"
       },
+      {
+        "returnsCollection": false,
+        "docUrl": "https://www.datocms.com/docs/content-management-api/resources/item/current_vs_published_state",
+        "rel": "current_vs_published_state",
+        "urlTemplate": "/items/${itemId}/current-vs-published-state",
+        "method": "GET",
+        "comment": "Retrieve information regarding changes between current and published versions of the record",
+        "urlPlaceholder": {
+          "variableName": "itemId",
+          "isEntityId": true,
+          "relType": "ItemData"
+        },
+        "optionalRequestBody": false,
+        "queryParamsRequired": false,
+        "responseType": "ItemCurrentVsPublishedStateTargetSchema",
+        "deprecated": "This API call is to be considered private and might change without notice",
+        "name": "currentVsPublishedState",
+        "rawName": "rawCurrentVsPublishedState"
+      },
       {
         "returnsCollection": false,
         "docUrl": "https://www.datocms.com/docs/content-management-api/resources/item/destroy",
@@ -1485,6 +1580,7 @@
           "isEntityId": true,
           "relType": "ItemData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ItemDestroyJobSchema",
         "name": "destroy",
@@ -1497,6 +1593,7 @@
         "urlTemplate": "/items",
         "method": "DELETE",
         "comment": "Delete multiple records",
+        "optionalRequestBody": false,
         "queryParamsType": "ItemBatchDestroyHrefSchema",
         "queryParamsRequired": true,
         "responseType": "ItemBatchDestroyJobSchema",
@@ -1511,6 +1608,7 @@
         "urlTemplate": "/items/publish",
         "method": "PUT",
         "comment": "Publish multiple records",
+        "optionalRequestBody": false,
         "queryParamsType": "ItemBatchPublishHrefSchema",
         "queryParamsRequired": true,
         "responseType": "ItemBatchPublishJobSchema",
@@ -1525,6 +1623,7 @@
         "urlTemplate": "/items/unpublish",
         "method": "PUT",
         "comment": "Unpublish multiple records",
+        "optionalRequestBody": false,
         "queryParamsType": "ItemBatchUnpublishHrefSchema",
         "queryParamsRequired": true,
         "responseType": "ItemBatchUnpublishJobSchema",
@@ -1544,6 +1643,16 @@
           "isEntityId": true,
           "relType": "ItemData"
         },
+        "requestBodyType": "ItemPublishSchema",
+        "optionalRequestBody": true,
+        "requestStructure": {
+          "type": "selective_publish_operation",
+          "attributes": [
+            "content_in_locales",
+            "non_localized_content"
+          ],
+          "relationships": []
+        },
         "queryParamsType": "ItemPublishHrefSchema",
         "queryParamsRequired": false,
         "responseType": "ItemPublishTargetSchema",
@@ -1562,6 +1671,15 @@
           "isEntityId": true,
           "relType": "ItemData"
         },
+        "requestBodyType": "ItemUnpublishSchema",
+        "optionalRequestBody": true,
+        "requestStructure": {
+          "type": "selective_unpublish_operation",
+          "attributes": [
+            "content_in_locales"
+          ],
+          "relationships": []
+        },
         "queryParamsType": "ItemUnpublishHrefSchema",
         "queryParamsRequired": false,
         "responseType": "ItemUnpublishTargetSchema",
@@ -1576,6 +1694,7 @@
         "method": "POST",
         "comment": "Publish items in bulk",
         "requestBodyType": "ItemBulkPublishSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item_bulk_publish_operation",
           "attributes": [],
@@ -1596,6 +1715,7 @@
         "method": "POST",
         "comment": "Unpublish items in bulk",
         "requestBodyType": "ItemBulkUnpublishSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item_bulk_unpublish_operation",
           "attributes": [],
@@ -1616,6 +1736,7 @@
         "method": "POST",
         "comment": "Destroy items in bulk",
         "requestBodyType": "ItemBulkDestroySchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item_bulk_destroy_operation",
           "attributes": [],
@@ -1636,6 +1757,7 @@
         "method": "POST",
         "comment": "Move items to stage in bulk",
         "requestBodyType": "ItemBulkMoveToStageSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item_bulk_move_to_stage_operation",
           "attributes": [
@@ -1669,6 +1791,7 @@
           "isEntityId": true,
           "relType": "ItemVersionData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ItemVersionRestoreJobSchema",
         "name": "restore",
@@ -1686,6 +1809,7 @@
           "isEntityId": false,
           "relType": "ItemData"
         },
+        "optionalRequestBody": false,
         "queryParamsType": "ItemVersionInstancesHrefSchema",
         "queryParamsRequired": false,
         "responseType": "ItemVersionInstancesTargetSchema",
@@ -1708,6 +1832,7 @@
           "isEntityId": true,
           "relType": "ItemVersionData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ItemVersionSelfTargetSchema",
         "name": "find",
@@ -1728,6 +1853,7 @@
         "method": "POST",
         "comment": "Create a new upload",
         "requestBodyType": "UploadCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "upload",
           "attributes": [
@@ -1752,6 +1878,7 @@
         "urlTemplate": "/uploads",
         "method": "GET",
         "comment": "List all uploads",
+        "optionalRequestBody": false,
         "queryParamsType": "UploadInstancesHrefSchema",
         "queryParamsRequired": false,
         "responseType": "UploadInstancesTargetSchema",
@@ -1774,6 +1901,7 @@
           "isEntityId": true,
           "relType": "UploadData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "UploadSelfTargetSchema",
         "name": "find",
@@ -1791,6 +1919,7 @@
           "isEntityId": true,
           "relType": "UploadData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "UploadDestroyTargetSchema",
         "name": "destroy",
@@ -1809,8 +1938,10 @@
           "relType": "UploadData"
         },
         "requestBodyType": "UploadUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "upload",
+          "idRequired": true,
           "attributes": [
             "path",
             "basename",
@@ -1837,6 +1968,7 @@
         "method": "PUT",
         "comment": "Batch add tags to uploads",
         "requestBodyType": "UploadBatchAddTagsSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "upload",
           "attributes": [
@@ -1858,6 +1990,7 @@
         "urlTemplate": "/uploads/batch-destroy",
         "method": "DELETE",
         "comment": "Delete multiple uploads",
+        "optionalRequestBody": false,
         "queryParamsType": "UploadBatchDestroyHrefSchema",
         "queryParamsRequired": false,
         "responseType": "UploadBatchDestroyJobSchema",
@@ -1877,6 +2010,7 @@
           "isEntityId": true,
           "relType": "UploadData"
         },
+        "optionalRequestBody": false,
         "queryParamsType": "UploadReferencesHrefSchema",
         "queryParamsRequired": false,
         "responseType": "UploadReferencesTargetSchema",
@@ -1891,6 +2025,7 @@
         "method": "POST",
         "comment": "Add tags to assets in bulk",
         "requestBodyType": "UploadBulkTagSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "upload_bulk_tag_operation",
           "attributes": [
@@ -1913,6 +2048,7 @@
         "method": "POST",
         "comment": "Destroy uploads",
         "requestBodyType": "UploadBulkDestroySchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "upload_bulk_destroy_operation",
           "attributes": [],
@@ -1940,6 +2076,7 @@
         "method": "POST",
         "comment": "Request a new upload",
         "requestBodyType": "UploadRequestCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "upload_request",
           "attributes": [
@@ -1972,10 +2109,12 @@
           "relType": "ItemData"
         },
         "requestBodyType": "ScheduledPublicationCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "scheduled_publication",
           "attributes": [
-            "publication_scheduled_at"
+            "publication_scheduled_at",
+            "selective_publication"
           ],
           "relationships": []
         },
@@ -1996,6 +2135,7 @@
           "isEntityId": false,
           "relType": "ItemData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ScheduledPublicationDestroyTargetSchema",
         "name": "destroy",
@@ -2021,10 +2161,12 @@
           "relType": "ItemData"
         },
         "requestBodyType": "ScheduledUnpublishingCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "scheduled_unpublishing",
           "attributes": [
-            "unpublishing_scheduled_at"
+            "unpublishing_scheduled_at",
+            "content_in_locales"
           ],
           "relationships": []
         },
@@ -2045,6 +2187,7 @@
           "isEntityId": false,
           "relType": "ItemData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ScheduledUnpublishingDestroyTargetSchema",
         "name": "destroy",
@@ -2064,6 +2207,7 @@
         "urlTemplate": "/search-results",
         "method": "GET",
         "comment": "Search for results",
+        "optionalRequestBody": false,
         "queryParamsType": "SearchResultInstancesHrefSchema",
         "queryParamsRequired": true,
         "responseType": "SearchResultInstancesTargetSchema",
@@ -2094,8 +2238,10 @@
           "relType": "EnvironmentData"
         },
         "requestBodyType": "EnvironmentForkSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "environment",
+          "idRequired": true,
           "attributes": [],
           "relationships": []
         },
@@ -2117,6 +2263,7 @@
           "isEntityId": true,
           "relType": "EnvironmentData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "EnvironmentPromoteTargetSchema",
         "name": "promote",
@@ -2129,6 +2276,7 @@
         "urlTemplate": "/environments",
         "method": "GET",
         "comment": "List all environments",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "EnvironmentInstancesTargetSchema",
         "name": "list",
@@ -2146,6 +2294,7 @@
           "isEntityId": true,
           "relType": "EnvironmentData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "EnvironmentSelfTargetSchema",
         "name": "find",
@@ -2163,6 +2312,7 @@
           "isEntityId": true,
           "relType": "EnvironmentData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "EnvironmentDestroyJobSchema",
         "name": "destroy",
@@ -2182,6 +2332,7 @@
         "urlTemplate": "/maintenance-mode",
         "method": "GET",
         "comment": "Retrieve maintenence mode",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "MaintenanceModeSelfTargetSchema",
         "name": "find",
@@ -2194,6 +2345,7 @@
         "urlTemplate": "/maintenance-mode/activate",
         "method": "PUT",
         "comment": "Activate maintenance mode: this means that the primary environment will be read-only",
+        "optionalRequestBody": false,
         "queryParamsType": "MaintenanceModeActivateHrefSchema",
         "queryParamsRequired": false,
         "responseType": "MaintenanceModeActivateTargetSchema",
@@ -2207,6 +2359,7 @@
         "urlTemplate": "/maintenance-mode/deactivate",
         "method": "PUT",
         "comment": "De-activate maintenance mode",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "MaintenanceModeDeactivateTargetSchema",
         "name": "deactivate",
@@ -2227,6 +2380,7 @@
         "method": "POST",
         "comment": "Create a new webhook",
         "requestBodyType": "WebhookCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "webhook",
           "attributes": [
@@ -2261,8 +2415,10 @@
           "relType": "UserData"
         },
         "requestBodyType": "WebhookUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "webhook",
+          "idRequired": true,
           "attributes": [
             "name",
             "url",
@@ -2289,6 +2445,7 @@
         "urlTemplate": "/webhooks",
         "method": "GET",
         "comment": "List all webhooks",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "WebhookInstancesTargetSchema",
         "name": "list",
@@ -2306,6 +2463,7 @@
           "isEntityId": false,
           "relType": "UserData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "WebhookSelfTargetSchema",
         "name": "find",
@@ -2323,6 +2481,7 @@
           "isEntityId": false,
           "relType": "UserData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "WebhookDestroyTargetSchema",
         "name": "destroy",
@@ -2342,6 +2501,7 @@
         "urlTemplate": "/webhook_calls",
         "method": "GET",
         "comment": "List all webhooks calls",
+        "optionalRequestBody": false,
         "queryParamsType": "WebhookCallInstancesHrefSchema",
         "queryParamsRequired": false,
         "responseType": "WebhookCallInstancesTargetSchema",
@@ -2364,6 +2524,7 @@
           "isEntityId": false,
           "relType": "UserData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "name": "resendWebhook",
         "rawName": "rawResendWebhook"
@@ -2382,6 +2543,7 @@
         "urlTemplate": "/build-triggers",
         "method": "GET",
         "comment": "List all build triggers for a site",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "BuildTriggerInstancesTargetSchema",
         "name": "list",
@@ -2399,6 +2561,7 @@
           "isEntityId": true,
           "relType": "BuildTriggerData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "BuildTriggerSelfTargetSchema",
         "name": "find",
@@ -2412,6 +2575,7 @@
         "method": "POST",
         "comment": "Create build trigger",
         "requestBodyType": "BuildTriggerCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "build_trigger",
           "attributes": [
@@ -2443,8 +2607,10 @@
           "relType": "BuildTriggerData"
         },
         "requestBodyType": "BuildTriggerUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "build_trigger",
+          "idRequired": true,
           "attributes": [
             "name",
             "adapter",
@@ -2472,6 +2638,7 @@
           "isEntityId": true,
           "relType": "BuildTriggerData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "name": "trigger",
         "rawName": "rawTrigger"
@@ -2488,6 +2655,7 @@
           "isEntityId": true,
           "relType": "BuildTriggerData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "name": "abort",
         "rawName": "rawAbort"
@@ -2504,6 +2672,7 @@
           "isEntityId": true,
           "relType": "BuildTriggerData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "name": "abortIndexing",
         "rawName": "rawAbortIndexing"
@@ -2520,6 +2689,7 @@
           "isEntityId": true,
           "relType": "BuildTriggerData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "name": "reindex",
         "rawName": "rawReindex"
@@ -2536,6 +2706,7 @@
           "isEntityId": true,
           "relType": "BuildTriggerData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "BuildTriggerDestroyTargetSchema",
         "name": "destroy",
@@ -2556,6 +2727,7 @@
         "method": "POST",
         "comment": "Create a new filter",
         "requestBodyType": "ItemTypeFilterCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item_type_filter",
           "attributes": [
@@ -2587,8 +2759,10 @@
           "relType": "ItemTypeFilterData"
         },
         "requestBodyType": "ItemTypeFilterUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "item_type_filter",
+          "idRequired": true,
           "attributes": [
             "name",
             "columns",
@@ -2612,6 +2786,7 @@
         "urlTemplate": "/item-type-filters",
         "method": "GET",
         "comment": "List all filters",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ItemTypeFilterInstancesTargetSchema",
         "name": "list",
@@ -2629,6 +2804,7 @@
           "isEntityId": true,
           "relType": "ItemTypeFilterData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ItemTypeFilterSelfTargetSchema",
         "name": "find",
@@ -2646,6 +2822,7 @@
           "isEntityId": true,
           "relType": "ItemTypeFilterData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "ItemTypeFilterDestroyTargetSchema",
         "name": "destroy",
@@ -2666,6 +2843,7 @@
         "method": "POST",
         "comment": "Create a new filter",
         "requestBodyType": "UploadFilterCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "upload_filter",
           "attributes": [
@@ -2693,8 +2871,10 @@
           "relType": "UploadFilterData"
         },
         "requestBodyType": "UploadFilterUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "upload_filter",
+          "idRequired": true,
           "attributes": [
             "name",
             "shared",
@@ -2714,6 +2894,7 @@
         "urlTemplate": "/upload-filters",
         "method": "GET",
         "comment": "List all filters",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "UploadFilterInstancesTargetSchema",
         "name": "list",
@@ -2731,6 +2912,7 @@
           "isEntityId": true,
           "relType": "UploadFilterData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "UploadFilterSelfTargetSchema",
         "name": "find",
@@ -2748,6 +2930,7 @@
           "isEntityId": true,
           "relType": "UploadFilterData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "UploadFilterDestroyTargetSchema",
         "name": "destroy",
@@ -2768,6 +2951,7 @@
         "method": "POST",
         "comment": "Invite a new user",
         "requestBodyType": "SiteInvitationCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "site_invitation",
           "attributes": [
@@ -2795,8 +2979,10 @@
           "relType": "SiteInvitationData"
         },
         "requestBodyType": "SiteInvitationUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "site_invitation",
+          "idRequired": true,
           "attributes": [],
           "relationships": [
             "role"
@@ -2814,6 +3000,7 @@
         "urlTemplate": "/site-invitations",
         "method": "GET",
         "comment": "List all invitations",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SiteInvitationInstancesTargetSchema",
         "name": "list",
@@ -2831,6 +3018,7 @@
           "isEntityId": true,
           "relType": "SiteInvitationData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SiteInvitationSelfTargetSchema",
         "name": "find",
@@ -2848,6 +3036,7 @@
           "isEntityId": true,
           "relType": "SiteInvitationData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SiteInvitationDestroyTargetSchema",
         "name": "destroy",
@@ -2865,6 +3054,7 @@
           "isEntityId": true,
           "relType": "SiteInvitationData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "name": "resend",
         "rawName": "rawResend"
@@ -2883,6 +3073,7 @@
         "urlTemplate": "/editing-sessions",
         "method": "GET",
         "comment": "List all editing sessions",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "EditingSessionInstancesTargetSchema",
         "deprecated": "This API call is to be considered private and might change without notice",
@@ -2902,6 +3093,7 @@
           "relType": "EditingSessionData"
         },
         "requestBodyType": "EditingSessionUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "*",
           "attributes": [],
@@ -2928,6 +3120,7 @@
           "isEntityId": true,
           "relType": "EditingSessionData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "EditingSessionDestroyTargetSchema",
         "deprecated": "This API call is to be considered private and might change without notice",
@@ -2948,6 +3141,7 @@
         "urlTemplate": "/sso-groups",
         "method": "GET",
         "comment": "List all SSO groups",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SsoGroupInstancesTargetSchema",
         "name": "list",
@@ -2965,6 +3159,7 @@
           "isEntityId": true,
           "relType": "SsoGroupData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SsoGroupCopyRolesTargetSchema",
         "name": "copyRoles",
@@ -2983,8 +3178,10 @@
           "relType": "SsoGroupData"
         },
         "requestBodyType": "SsoGroupUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "sso_group",
+          "idRequired": true,
           "attributes": [
             "priority"
           ],
@@ -3009,6 +3206,7 @@
           "isEntityId": true,
           "relType": "SsoGroupData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SsoGroupDestroyTargetSchema",
         "name": "destroy",
@@ -3028,6 +3226,7 @@
         "urlTemplate": "/sso-settings",
         "method": "GET",
         "comment": "Retrieve SSO Settings",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SsoSettingsSelfTargetSchema",
         "name": "find",
@@ -3040,6 +3239,7 @@
         "urlTemplate": "/sso-settings/generate-token",
         "method": "PUT",
         "comment": "Generate SSO token",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SsoSettingsGenerateTokenTargetSchema",
         "name": "generateToken",
@@ -3053,8 +3253,10 @@
         "method": "PUT",
         "comment": "Update SSO Settings",
         "requestBodyType": "SsoSettingsUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "sso_settings",
+          "idRequired": true,
           "attributes": [
             "idp_saml_metadata_url",
             "idp_saml_metadata_xml"
@@ -3082,6 +3284,7 @@
         "urlTemplate": "/white-label-settings",
         "method": "GET",
         "comment": "Retrieve white-label settings",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "WhiteLabelSettingsSelfTargetSchema",
         "name": "find",
@@ -3095,8 +3298,10 @@
         "method": "PUT",
         "comment": "Update white-label settings",
         "requestBodyType": "WhiteLabelSettingsUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "white_label_settings",
+          "idRequired": true,
           "attributes": [
             "custom_i18n_messages_template_url"
           ],
@@ -3121,6 +3326,7 @@
         "urlTemplate": "/public-info",
         "method": "GET",
         "comment": "Retrieve public site info",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "PublicInfoSelfTargetSchema",
         "name": "find",
@@ -3140,6 +3346,7 @@
         "urlTemplate": "/daily-site-usages",
         "method": "GET",
         "comment": "Retrieve project's daily usage info",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "DailyUsageInstancesTargetSchema",
         "name": "list",
@@ -3164,6 +3371,7 @@
           "isEntityId": true,
           "relType": "UsageCounterData"
         },
+        "optionalRequestBody": false,
         "queryParamsType": "UsageCounterSelfHrefSchema",
         "queryParamsRequired": false,
         "responseType": "UsageCounterSelfTargetSchema",
@@ -3184,6 +3392,7 @@
         "urlTemplate": "/upload-tags",
         "method": "GET",
         "comment": "List all manually created upload tags",
+        "optionalRequestBody": false,
         "queryParamsType": "UploadTagInstancesHrefSchema",
         "queryParamsRequired": false,
         "responseType": "UploadTagInstancesTargetSchema",
@@ -3202,6 +3411,7 @@
         "method": "POST",
         "comment": "Create a new upload tag",
         "requestBodyType": "UploadTagCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "upload_tag",
           "attributes": [
@@ -3228,6 +3438,7 @@
         "urlTemplate": "/upload-smart-tags",
         "method": "GET",
         "comment": "List all automatically created upload tags",
+        "optionalRequestBody": false,
         "queryParamsType": "UploadSmartTagInstancesHrefSchema",
         "queryParamsRequired": false,
         "responseType": "UploadSmartTagInstancesTargetSchema",
@@ -3252,6 +3463,7 @@
         "urlTemplate": "/site",
         "method": "GET",
         "comment": "Retrieve the site",
+        "optionalRequestBody": false,
         "queryParamsType": "SiteSelfHrefSchema",
         "queryParamsRequired": false,
         "responseType": "SiteSelfTargetSchema",
@@ -3266,8 +3478,10 @@
         "method": "PUT",
         "comment": "Update the site's settings",
         "requestBodyType": "SiteUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "site",
+          "idRequired": true,
           "attributes": [
             "no_index",
             "favicon",
@@ -3295,6 +3509,7 @@
         "urlTemplate": "/site/activate-improved-timezone-management",
         "method": "PUT",
         "comment": "Activate improved timezone management",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SiteActivateImprovedTimezoneManagementJobSchema",
         "deprecated": "This API call is to be considered private and might change without notice",
@@ -3308,6 +3523,7 @@
         "urlTemplate": "/site/activate-improved-hex-management",
         "method": "PUT",
         "comment": "Activate improved hex management",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SiteActivateImprovedHexManagementTargetSchema",
         "deprecated": "This API call is to be considered private and might change without notice",
@@ -3321,6 +3537,7 @@
         "urlTemplate": "/site/activate-improved-gql-multilocale-fields",
         "method": "PUT",
         "comment": "Activate improved GraphQL multi-locale fields option",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "SiteActivateImprovedGqlMultilocaleFieldsTargetSchema",
         "deprecated": "This API call is to be considered private and might change without notice",
@@ -3342,6 +3559,7 @@
         "method": "POST",
         "comment": "Create a new workflow",
         "requestBodyType": "WorkflowCreateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "workflow",
           "attributes": [
@@ -3369,8 +3587,10 @@
           "relType": "WorkflowData"
         },
         "requestBodyType": "WorkflowUpdateSchema",
+        "optionalRequestBody": false,
         "requestStructure": {
           "type": "workflow",
+          "idRequired": true,
           "attributes": [
             "name",
             "api_key",
@@ -3390,6 +3610,7 @@
         "urlTemplate": "/workflows",
         "method": "GET",
         "comment": "List all workflows",
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "WorkflowInstancesTargetSchema",
         "name": "list",
@@ -3407,6 +3628,7 @@
           "isEntityId": true,
           "relType": "WorkflowData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "responseType": "WorkflowSelfTargetSchema",
         "name": "find",
@@ -3424,6 +3646,7 @@
           "isEntityId": true,
           "relType": "WorkflowData"
         },
+        "optionalRequestBody": false,
         "queryParamsRequired": false,
         "name": "destroy",
         "rawName": "rawDestroy"