chore(docs): Updated API Reference (v2) (#9033)

Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action

Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>

www/apps/api-reference/specs/admin/paths/admin_api-keys.yaml

@@ -1286,9 +1286,15 @@ get:
 post:
   operationId: PostApiKeys
   summary: Create Api Key
-  description: Create a api key.
+  description: >
+    Create a secret or publishable API key.
+
+    A secret API key is used for admin authentication.
+
+
+    A publishable API key is used by client applications to set the scope of the
+    request.
   x-authenticated: true
-  parameters: []
   security:
     - api_token: []
     - cookie_auth: []