Merge pull request #415 from codatio/library-update

Automated PR created by OAS bot

Author: dcoplowe

README.md

@@ -1,36 +1,38 @@
-<div align="center">
+<div align="center">
     <picture>
         <source srcset="https://user-images.githubusercontent.com/6267663/221800355-0995e4ad-a386-4943-a4c2-e620341a5155.svg" media="(prefers-color-scheme: dark)">
         <img src="https://user-images.githubusercontent.com/6267663/221800359-b7f7776c-a44f-4384-8dd0-d9f7d5caef7d.svg">
     </picture>
     <h1>Codat Python</h1>
-        <p><strong>The universal API for small business data</strong></p>
-        <p>Codat solves the connectivity challenge for developers building the next generation of financial products for small businesses. We're experts in how your application interacts with the other software your customer use, so you can focus on what makes you superior.</p>
+        <p><strong>The API for lending and embedded accounting automation</strong></p>
+        <p>Codat makes it quicker and easier to build fintech products, like corporate cards, business dashboards, or SMB lending applications, that are integrated with the other systems small businesses use.</p>
     <a href="https://docs.codat.io/using-the-api/overview"><img src="https://img.shields.io/static/v1?label=Docs&message=API Ref&color=4c2cec&style=for-the-badge" /></a>
     <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" /></a>
 </div>
 
 > **Beta Release**
-> 
+>
 > Exciting news! Our first Python library beta release is here, simplifying your development workflow with an effortless build process.
 
 ## Authentication
 
-Codat uses API keys to control access to the API.
+Codat uses API keys to control access to the API. 
+Learn more about authentication and managing API keys [here](https://docs.codat.io/using-the-api/authentication).
 
-You must keep the API key secret, so make sure it isn't available in publicly accessible areas, such as GitHub and client-side code. Codat recommends the API key is only inserted at release time, and the number of people at your organization with access to your API key is minimised.
+You must keep the API key secret, so make sure it isn't available in publicly accessible areas, such as GitHub and client-side code.
+Codat recommends the API key is only inserted at release time, and the number of people at your organization with access to your API key is minimised.
 
 Codat expects the API key to be included in all API requests to the server, Base64 encoded within an 'Authorization' header.
 
 ```bash
-Authorization: Basic YOUR_ENCODED_API_KEY
+Authorization: Basic BASE_64_ENCODED(API_KEY)
 ```
 
 ### Getting your Authorization Header
 
-To get your authorization header from the Codat Portal:
+To get your authorization header from the [Codat Portal](https://app.codat.io):
 
-1. In the navigation bar, click **Developers > API keys**.
+1. In the navigation bar, click [**Developers > API keys**](https://app.codat.io/developers/api-keys).
 2. In the **API Keys** section, copy your authorization header rather than the API key itself.
 
 ## Client Libraries
@@ -45,6 +47,7 @@ To get your authorization header from the Codat Portal:
 | **[Lending](https://github.com/codatio/client-sdk-python/tree/main/lending)** | Make credit decisions backed by enhanced financials, metrics, reports, and data integrity features. | [codat-lending](https://pypi.org/project/codat-lending) |
 | **[Sync for Payroll](https://github.com/codatio/client-sdk-python/tree/main/sync-for-payroll)** | Push payroll to accounting platforms. | [codat-sync-for-payroll](https://pypi.org/project/codat-sync-for-payroll) |
 | **[Sync for Payables](https://github.com/codatio/client-sdk-python/tree/main/sync-for-payables)** | Streamline your customers' accounts payable workflow. | [codat-sync-for-payables](https://pypi.org/project/codat-sync-for-payables) |
+
 ### Previous products and versions
 
 | Library | Description | PyPI |

bank-feeds/README.md

@@ -1,8 +1,8 @@
 # Bank Feeds
 
 <!-- Start Codat Library Description -->
-<!-- End Codat Library Description  -->
 Bank Feeds API enables your SMB users to set up bank feeds from accounts in your application to supported accounting platforms.
+<!-- End Codat Library Description  -->
 
 <!-- Start SDK Installation -->
 ## SDK Installation

bank-feeds/gen.yaml

@@ -20,6 +20,7 @@ features:
 python:
   version: 3.1.0
   author: Codat
-  description: Set up bank feeds from accounts in your application to supported accounting platforms.
+  description: Set up bank feeds from accounts in your application to supported accounting
+    platforms.
   maxMethodParams: 0
   packageName: codat-bankfeeds

lending/README.md

@@ -1,8 +1,8 @@
 # Lending
 
 <!-- Start Codat Library Description -->
-<!-- End Codat Library Description  -->
 Lending helps you make smarter credit decisions on small businesses by enabling you to pull your customers' latest data from the operating systems they are already using. You can use that data for automating decisioning and surfacing new insights on the customer, all via one API.
+<!-- End Codat Library Description  -->
 
 <!-- Start SDK Installation -->
 ## SDK Installation

lending/gen.yaml

@@ -21,6 +21,7 @@ features:
 python:
   version: 4.2.0
   author: Codat
-  description: Make credit decisions backed by enhanced financials, metrics, reports, and data integrity features.
+  description: Make credit decisions backed by enhanced financials, metrics, reports,
+    and data integrity features.
   maxMethodParams: 0
   packageName: codat-lending

platform/gen.yaml

@@ -20,6 +20,7 @@ features:
 python:
   version: 1.1.0
   author: Codat
-  description: Manage the building blocks of Codat, including companies, connections, and more.
+  description: Manage the building blocks of Codat, including companies, connections,
+    and more.
   maxMethodParams: 0
   packageName: codat-platform

previous-versions/accounting/README.md

@@ -1,9 +1,9 @@
 # Accounting
 
 <!-- Start Codat Library Description -->
-<!-- End Codat Library Description  -->
 Codat's Accounting API is a flexible API for pulling and pushing up-to-date accounting data to your customer's accounting software.
 It gives you a simple way to view, create, update adn delete data without having to worry about each platform's specific complexities.
+<!-- End Codat Library Description  -->
 
 
 <!-- Start SDK Installation -->
@@ -247,4 +247,4 @@ if res.account_transaction is not None:
 * [list](docs/sdks/transfers/README.md#list) - List transfers
 * [upload_attachment](docs/sdks/transfers/README.md#upload_attachment) - Push invoice attachment
 <!-- End SDK Available Operations -->
-### Library generated by [Speakeasy](https://docs.speakeasyapi.dev/docs/using-speakeasy/client-sdks)
+### Library generated by [Speakeasy](https://docs.speakeasyapi.dev/docs/using-speakeasy/client-sdks)

previous-versions/banking/README.md

@@ -1,8 +1,8 @@
 # Banking
 
 <!-- Start Codat Library Description -->
-<!-- End Codat Library Description  -->
 Use Codat's API to connect to your SMB customer's banks and pull up-to-date standardized account and transaction data from their bank accounts via our partner providers.
+<!-- End Codat Library Description  -->
 
 <!-- Start SDK Installation -->
 ## SDK Installation

previous-versions/commerce/README.md

@@ -1,6 +1,8 @@
-# Commerce API
+# Commerce
 
 <!-- Start Codat Library Description -->
+Codat's Commerce API enables you to pull up-date-date commerce data from several leading payments, point-of-sale, and eCommerce systems.
+You can view your SMB customers' products, orders, payments, payouts, disputes, and more - all standardized to our Commerce data model.
 <!-- End Codat Library Description  -->
 
 <!-- Start SDK Installation -->
@@ -15,4 +17,4 @@ replace me
 <!-- Start SDK Available Operations -->
 replace me
 <!-- End SDK Available Operations -->
-### Library generated by [Speakeasy](https://docs.speakeasyapi.dev/docs/using-speakeasy/client-sdks)
+### Library generated by [Speakeasy](https://docs.speakeasyapi.dev/docs/using-speakeasy/client-sdks)

previous-versions/sync-for-commerce-version-1/README.md

@@ -1,8 +1,8 @@
 # Sync for Commerce version 1
 
 <!-- Start Codat Library Description -->
-<!-- End Codat Library Description  -->
 Embedded accounting integrations for POS and eCommerce platforms.
+<!-- End Codat Library Description  -->
 
 <!-- Start SDK Installation -->
 ## SDK Installation