chore(docs): Generated API Reference (#4706)

Co-authored-by: olivermrbl <olivermrbl@users.noreply.github.com> Co-authored-by: Shahed Nasser <shahednasser@gmail.com>
2023-08-07 16:54:48 +03:00
parent efdea04963
commit 658339767b
1138 changed files with 11740 additions and 7043 deletions
@@ -1,7 +1,12 @@
 title: Publishable API key
 description: >-
-  Publishable API key defines scopes (i.e. resources) that are available within
-  a request.
+  A Publishable API key defines scopes that resources are available in. Then, it
+  can be used in request to infer the resources without having to directly pass
+  them. For example, a publishable API key can be associated with one or more
+  sales channels. Then, when the publishable API key is passed in the header of
+  a request, it is inferred what sales channel is being used without having to
+  pass the sales channel as a query or body parameter of the request.
+  Publishable API keys can only be used with sales channels, at the moment.
 type: object
 required:
  - created_at