Update en to output generated at 370834b

Author: bszwarc

openapi.json

@@ -37752,279 +37752,343 @@
   "tags": [
     {
       "name": "Authorization",
+      "description": "A set of endpoints used to\nmanage user authorization process.",
       "x-box-tag": "authorization",
       "x-box-priority": true
     },
     {
       "name": "Sign requests",
+      "description": "Sign requests are used\nto submit a file for\nsignature.",
       "x-box-tag": "sign_requests"
     },
     {
       "name": "Classifications",
+      "description": "Classification labels are\nused for content that is\nsensitive or under security\nrestrictions.",
       "x-box-tag": "classifications"
     },
     {
       "name": "Classifications on files",
+      "description": "Classification labels are\nused for files that are\nsensitive or under security\nrestrictions.",
       "x-box-tag": "file_classifications"
     },
     {
       "name": "Classifications on folders",
+      "description": "Classification labels are\nused for folders that are\nsensitive or under security\nrestrictions.",
       "x-box-tag": "folder_classifications"
     },
     {
       "name": "Collaborations",
+      "description": "Collaborations define access permissions\nfor users and groups to files and folders,\nsimilar to access control lists.",
       "x-box-tag": "user_collaborations"
     },
     {
       "name": "Collaborations (List)",
+      "description": "A set of endpoints used to\nretrieve file, folder,\npending, and group collaborations.",
       "x-box-tag": "list_collaborations"
     },
     {
       "name": "Collections",
+      "description": "Collections are a way to group files,\nfolders, and web links without putting them\nall into a folder.",
       "x-box-tag": "collections"
     },
     {
       "name": "Comments",
+      "description": "Comments are messages generated by users on files,\nallowing users to collaborate on a file,\ndiscussing any feedback they might\nhave on the content.",
       "x-box-tag": "comments"
     },
     {
       "name": "Device pinners",
+      "description": "Device pinners allow enterprises to\ncontrol what devices can use\nnative Box applications.",
       "x-box-tag": "device_pinners"
     },
     {
       "name": "Domain restrictions (User exemptions)",
+      "description": "A set of endpoints that allow exempting users\nfrom restrictions imposed by the list of\nallowed collaboration domains for a specific enterprise.",
       "x-box-tag": "collaboration_allowlist_exempt_targets"
     },
     {
       "name": "Domain restrictions for collaborations",
+      "description": "A set of endpoints that manage domains for which users\ncan collaborate with files and folders in an enterprise.",
       "x-box-tag": "collaboration_allowlist_entries"
     },
     {
       "name": "Downloads",
+      "description": "Downloads allow saving files to the application's server,\nor directly by the end user in a browser.",
       "x-box-tag": "downloads"
     },
     {
       "name": "Email aliases",
+      "description": "Email aliases provide a list of emails additional\nto the user's primary login email.",
       "x-box-tag": "email_aliases"
     },
     {
       "name": "Events",
+      "description": "Events provide a way for an\napplication to subscribe to\nany actions performed by\nany user, users, or service in an enterprise.",
       "x-box-tag": "events"
     },
     {
       "name": "File requests",
+      "description": "File Requests provide a fast and\nsecure way to request files and associated metadata\nfrom anyone.\nUsers can create new file requests\nbased on an existing file request,\nupdate file request settings, activate, deactivate, and delete\nfile requests programmatically.",
       "x-box-tag": "file_requests"
     },
     {
       "name": "File version legal holds",
+      "description": "A legal hold is a process that an enterprise\ncan use to preserve all forms of potentially relevant\ninformation when\nlitigation is pending or reasonably anticipated.\nA File Version Legal Hold represents all the policies that\nare assigned to a specific file version.",
       "x-box-tag": "file_version_legal_holds"
     },
     {
       "name": "File version retentions",
+      "description": "A retention policy blocks permanent\ndeletion of content for a specified amount of time.\nA file version retention is a record for a retained file.",
       "x-box-tag": "file_version_retentions"
     },
     {
       "name": "File versions",
+      "description": "A set of endpoints used to manage specific\nversions of a file.",
       "x-box-tag": "file_versions"
     },
     {
       "name": "Files",
+      "description": "Files, together with Folders,\nare at the core of the Box API.\nFiles can be uploaded and downloaded,\nas well as hold important metadata\ninformation about the content.",
       "x-box-tag": "files"
     },
     {
       "name": "Folder Locks",
+      "description": "Folder locks define access restrictions\nplaced by folder owners to prevent\nspecific folders from being moved or deleted.",
       "x-box-tag": "folder_locks"
     },
     {
       "name": "Folders",
+      "description": "Folders, together with Files,\nare at the core of the Box API.\nFolders can be uploaded and downloaded,\nas well as hold important metadata\ninformation about the content.",
       "x-box-tag": "folders"
     },
     {
       "name": "Integration mappings",
+      "description": "Integration Mappings allow the users\nto manage where content from partner apps is stored in Box.",
       "x-box-tag": "integration_mappings"
     },
     {
       "name": "Group memberships",
+      "description": "Group memberships signify that\na user is a part of the group.",
       "x-box-tag": "memberships"
     },
     {
       "name": "Groups",
+      "description": "Groups created in an enterprise.",
       "x-box-tag": "groups"
     },
     {
       "name": "Invites",
+      "description": "Invites are used to invite the user to\nan enterprise.",
       "x-box-tag": "invites"
     },
     {
       "name": "Legal hold policies",
+      "description": "A legal hold is a process that an enterprise\ncan use to preserve all forms of potentially\nrelevant information when litigation is pending or\nreasonably anticipated.",
       "x-box-tag": "legal_hold_policies"
     },
     {
       "name": "Legal hold policy assignments",
+      "description": "A Legal Hold Policy Assignment\nis a relation between a policy and custodian.\nIn this case, a custodian can be a user, folder,\nfile, or file version.",
       "x-box-tag": "legal_hold_policy_assignments"
     },
     {
       "name": "Metadata cascade policies",
+      "description": "A metadata cascade policy describes how metadata\ninstances applied to a folder should be applied\nto any item within that folder.",
       "x-box-tag": "metadata_cascade_policies"
     },
     {
       "name": "Metadata instances (Files)",
+      "description": "A metadata instance describes\nthe relation between a template and a file,\nincluding the values that are assigned for every field.",
       "x-box-tag": "file_metadata"
     },
     {
       "name": "Metadata instances (Folders)",
+      "description": "A metadata instance describes the relation between a template and a folder,\nincluding the values that are assigned for every field.",
       "x-box-tag": "folder_metadata"
     },
     {
       "name": "Metadata templates",
+      "description": "A metadata template describes a reusable set\nof key/value pairs that can be assigned to a file.",
       "x-box-tag": "metadata_templates"
     },
     {
       "name": "Recent items",
+      "description": "Recent items represent items such\nas files or folders that\nthe user accessed recently.",
       "x-box-tag": "recent_items"
     },
     {
       "name": "Retention policies",
+      "description": "A retention policy blocks permanent deletion of content\nfor a specified amount of time. Admins can create\nretention policies and then assign them to\nspecific folders or their entire enterprise.",
       "x-box-tag": "retention_policies"
     },
     {
       "name": "Retention policy assignments",
+      "description": "A Retention Policy Assignment is a relation\nbetween a policy and folder or enterprise.\nCreating an assignment puts a retention on\nall the file versions that belong to that folder or enterprise.",
       "x-box-tag": "retention_policy_assignments"
     },
     {
       "name": "Search",
+      "description": "The Box API provides a way to find content in Box\nusing full-text search queries.",
       "x-box-tag": "search"
     },
     {
       "name": "Session termination",
+      "description": "Session termination API is used to\nvalidate the roles and permissions of the group,\nand creates asynchronous jobs to terminate the group's sessions.",
       "x-box-tag": "session_termination"
     },
     {
       "name": "Shared links (Files)",
+      "description": "Files shared links are URLs that are generated for files stored in Box,\nwhich provide direct, read-only access to the resource.",
       "x-box-tag": "shared_links_files"
     },
     {
       "name": "Shared links (Folders)",
+      "description": "Folders shared links are URLs that are generated for folders stored in Box,\nwhich provide direct, read-only access to the resource.",
       "x-box-tag": "shared_links_folders"
     },
     {
       "name": "Shared links (Web Links)",
+      "description": "Web links for files are URLs that are generated\nfor web links in Box,\nwhich provide direct, read-only access to the resource.",
       "x-box-tag": "shared_links_web_links"
     },
     {
       "name": "Shield information barriers",
+      "description": "Shield information barrier in Box defines an ethical wall.\nAn ethical wall is a mechanism that prevents exchanges or communication that\ncould lead to conflicts of interest and therefore result in\nbusiness activities ethically or legally questionable.",
       "x-box-tag": "shield_information_barriers"
     },
     {
       "name": "Shield information barrier segments",
+      "description": "Shield information barrier segment represents\na defined group of users. A user can be a member\nof only one segment, which makes segments\ndifferent from groups.",
       "x-box-tag": "shield_information_barrier_segments"
     },
     {
       "name": "Shield information barrier segment members",
+      "description": "Shield information barrier segment member\nrepresents a user that is assigned to a\nspecific segment.",
       "x-box-tag": "shield_information_barrier_segment_members"
     },
     {
       "name": "Shield information barrier reports",
+      "description": "Shield information barrier reports\ncontain information on what existing collaborations\nwill be removed permanently when the information barrier is enabled.",
       "x-box-tag": "shield_information_barrier_reports"
     },
     {
       "name": "Shield information barrier segment restrictions",
+      "description": "Shield information barrier segment restriction is\nan access restriction based on the content (file or folder) owner.",
       "x-box-tag": "shield_information_barrier_segment_restrictions"
     },
     {
       "name": "Sign templates",
+      "description": "Sign templates allow you to use a predefined Box Sign\ntemplate when creating a sign request.\nThe template includes placeholders that\nare automatically populated with data when creating the request.",
       "x-box-tag": "sign_templates"
     },
     {
       "name": "Skills",
+      "description": "Box Skills are designed to allow custom processing\nof files uploaded to Box, with the\nintent of enhancing the underlying metadata of the file.",
       "x-box-tag": "skills"
     },
     {
       "name": "Standard and Zones Storage Policies",
+      "description": "Storage policy assignment represents the\nstorage zone for items in a given enterprise.",
       "x-box-tag": "storage_policies"
     },
     {
       "name": "Standard and Zones Storage Policy Assignments",
+      "description": "Storage policy assignment represents the\nrelation between storage zone and the\nassigned item (for example a file stored\nin a specific zone).",
       "x-box-tag": "storage_policy_assignments"
     },
     {
       "name": "Task assignments",
+      "description": "A task assignment defines which\ntask is assigned to which user to complete.",
       "x-box-tag": "task_assignments"
     },
     {
       "name": "Tasks",
+      "description": "Tasks allow users to request collaborators on a file\nto review a file or complete a piece of work.\nTasks can be used by developers to create file-centric workflows.",
       "x-box-tag": "tasks"
     },
     {
       "name": "Terms of service",
+      "description": "A set of endpoints used to\nmanage terms of service agreements.",
       "x-box-tag": "terms_of_services"
     },
     {
       "name": "Terms of service user statuses",
+      "description": "A set of endpoints used to\nmanage the status of terms of service\nfor a particular user.",
       "x-box-tag": "terms_of_service_user_statuses"
     },
-    {
-      "name": "Termination message",
-      "x-box-tag": "termination_message"
-    },
     {
       "name": "Transfer folders",
+      "description": "API designed to move all of the items\n(files, folders and workflows)\nowned by a user into another user's account.",
       "x-box-tag": "transfer"
     },
     {
       "name": "Trashed files",
+      "description": "Files that were deleted and\nmoved to trash.",
       "x-box-tag": "trashed_files"
     },
     {
       "name": "Trashed folders",
+      "description": "Folders that were deleted and\nmoved to trash.",
       "x-box-tag": "trashed_folders"
     },
     {
       "name": "Trashed items",
+      "description": "Items that were deleted and\nmoved to trash.",
       "x-box-tag": "trashed_items"
     },
     {
       "name": "Trashed web links",
+      "description": "Web links that were deleted and\nmoved to trash.",
       "x-box-tag": "trashed_web_links"
     },
     {
       "name": "Uploads",
+      "description": "The direct file upload API supports files\nup to 50MB in size and sends all\nthe binary data to the Box API in 1 API request.",
       "x-box-tag": "uploads"
     },
     {
       "name": "Uploads (Chunked)",
+      "description": "The chunked upload endpoints support files from\n20MB in size and allow an application\nto upload the file in parts,\nallowing for more control to catch any errors\nand retry parts individually.",
       "x-box-tag": "chunked_uploads"
     },
     {
       "name": "User avatars",
+      "description": "User avatars are JPG or PNG files\nuploaded to Box to represent the\nuser image. They are then displayed\nin the user account.",
       "x-box-tag": "avatars"
     },
     {
       "name": "Users",
+      "description": "Box API supports a variety of users,\nranging from real employees\nlogging in with their Managed User account,\nto applications using App Users to drive powerful\nautomation workflows.",
       "x-box-tag": "users"
     },
     {
       "name": "Watermarks (Files)",
+      "description": "A watermark is a semi-transparent\noverlay on an embedded file\npreview that displays a viewer's email address\nor user ID and the time of access over\nthe file.",
       "x-box-tag": "file_watermarks"
     },
     {
       "name": "Watermarks (Folders)",
+      "description": "A watermark is a semi-transparent overlay on an embedded folder\npreview that displays a viewer's email address or user ID\nand the time of access over\nthe folder content.",
       "x-box-tag": "folder_watermarks"
     },
     {
       "name": "Web links",
+      "description": "Web links are objects that point to URLs.\nThese objects are also known as bookmarks\nwithin the Box web application.",
       "x-box-tag": "web_links"
     },
     {
       "name": "Webhooks",
+      "description": "Webhooks allow you to monitor Box content for events,\nand receive notifications to a URL of your choice when they occur.\nFor example, a workflow may include waiting\nfor a file to be downloaded to delete a shared link.",
       "x-box-tag": "webhooks"
     },
     {
       "name": "Workflows",
+      "description": "Box Relay Workflows are objects that represent\na named collection of flows.",
       "x-box-tag": "workflows"
     },
     {
       "name": "Zip Downloads",
+      "description": "Zip downloads represent a successful request\nto create a ZIP archive with files and folders.",
       "x-box-tag": "zip_downloads"
     }
   ],