Copy edits

Author: leslitagordita

openapi.yaml

@@ -11739,8 +11739,8 @@ paths:
       - url: https://api.linode.com/v4
       summary: View Object Storage SSL Cert
       description: |
-        Returns whether this bucket has a corresponding SSL certificate that was
-        uploaded by a user.
+        Returns a boolean value indicating if this bucket has a corresponding SSL certificate that was
+        uploaded by an Account user.
       tags:
       - Object Storage
       security:
@@ -11750,8 +11750,8 @@ paths:
       responses:
         '200':
           description: >
-            Returns whether this bucket has a corresponding SSL certificate
-            that was uploaded by a user.
+            Returns a boolean value indicating if this bucket has a corresponding SSL certificate that was
+            uploaded by an Account user.
           content:
             application/json:
               schema:
@@ -11774,7 +11774,7 @@ paths:
       - url: https://api.linode.com/v4
       summary: Upload Object Storage SSL Cert
       description: |
-        Upload an SSL certificate to be served when you visit your Object Storage bucket via HTTPS.
+        Upload an SSL certificate and private key to be served when you visit your Object Storage bucket via HTTPS.
         Your SSL certificate and private key are stored encrypted at rest.
       tags:
       - Object Storage
@@ -11787,7 +11787,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/ObjectStorageSSLResponse'
+              $ref: '#/components/schemas/ObjectStorageSSL'
       responses:
         '200':
           description: Returns whether this bucket has a corresponding SSL certificate that was uploaded by a user.
@@ -11820,7 +11820,7 @@ paths:
       - url: https://api.linode.com/v4
       summary: Delete Object Storage SSL Cert
       description: |
-        Deletes this Object Storage buckets user uploaded SSL certificate.
+        Deletes this Object Storage bucket's user uploaded SSL certificate and private key.
       tags:
       - Object Storage
       security:
@@ -18969,9 +18969,11 @@ components:
                 example: read_only
     ObjectStorageSSL:
       type: object
+      required:
+      - certificate
+      - private_key
       description: >
-        An Object in Object Storage, or a "prefix" that contains one
-        or more objects when a `delimiter` is used.
+        Upload an SSL certificate and private key to be served when you visit your Object Storage bucket via HTTPS.
       properties:
         certificate:
           type: string
@@ -18995,7 +18997,7 @@ components:
         ssl:
           type: boolean
           description: >
-            If this Bucket has a corresponding SSL certificate that was uploaded by a user.
+            A boolean indicating if this Bucket has a corresponding SSL certificate that was uploaded by an Account user.
           example: true
           readOnly: true
     PaginationEnvelope: