chore: started api documentation

apps/documentation/pages/_meta.json

@@ -20,9 +20,10 @@
     "title": "Local Development",
     "type": "page"
   },
-  "api": {
-    "title": "API",
-    "type": "page"
+  "public-api": {
+    "title": "Public API",
+    "type": "page",
+    "href": "/fcc/"
   },
   "webhooks": {
     "title": "Webhooks",

apps/documentation/pages/api/api.mdx

@@ -1,3 +0,0 @@
-# Hello world
-
-Hey there!

apps/documentation/pages/public-api/_meta.json

@@ -0,0 +1,6 @@
+{
+  "intro": "Intro",
+  "authentication": "Authentication",
+  "versioning": "Versioning",
+  "api-reference": "API Reference"
+}

apps/documentation/pages/public-api/authentication.mdx

@@ -0,0 +1,33 @@
+---
+title: 'API Authentication'
+description: 'Learn how to create a Documenso API key and authenticate your API requests.'
+---
+
+# API Authentication
+
+Documenso uses API keys for authentication. An API key is a unique token that is generated for each client. The client must provide the key whenever it makes an API call. This way, Documenso can identify the clients making the requests and authorize their access to the API.
+
+## Creating an API Key
+
+To create an API key, you need to navigate to the user settings page. Click on your avatar in the top right corner of the dashboard and select "**[User settings](https://app.documenso.com/settings)**" from the dropdown menu.
+
+![A screenshot of the Documenso's dashboard that shows the dropdown menu when you click on your user avatar](/public-api-images/documenso-user-dropdown-menu.webp)
+
+Once you're on the user settings page, navigate to the "**[API Tokens](https://app.documenso.com/settings/tokens)**" tab. The "API Token" page lists your existing keys and enables you to create new ones.
+
+![A screenshot of the Documenso's user settings page that shows the API Tokens page](/public-api-images/api-tokens-page-documenso.webp)
+
+To create a new API key, you must:
+
+- Choose a name (e.g. "zapier-key")
+  - we recommend using a descriptive name that helps you easily identify the key and its purpose
+- Choose an expiration date
+  - you can set the key to never expire or choose when to become invalid: 7 days, 1 month, 3 months, 6 months, or 1 year
+
+After providing the required information, click the "Create token" button to generate the API key.
+
+![A screenshot of the newly created API token in the Documenso dashboard](/public-api-images/documenso-api-key-blurred.webp)
+
+Once you've created the token, Documenso will display the key on the screen. Make sure to copy the key and store it securely. You won't be able to see the key again once you refresh/leave the page.
+
+## Using the API Key

apps/documentation/pages/public-api/intro.mdx

@@ -0,0 +1,9 @@
+# Public API
+
+## Swagger Documentation
+
+Documenso also provides [Swagger documentation](https://app.documenso.com/api/v1/openapi). This documentation provides information about the API endpoints, request parameters, response formats, and authentication methods.
+
+## Availability
+
+The API is available to individual users and teams.

apps/documentation/pages/webhooks/intro.mdx

@@ -18,11 +18,11 @@ Documenso supports Webhooks and allows you to subscribe to the following events:
 
 ## Create a webhook subscription
 
-You can create a webhook subscription from the user settings page. Click on your avatar in the top right corner of the dashboard and select "**User settings**" from the dropdown menu.
+You can create a webhook subscription from the user settings page. Click on your avatar in the top right corner of the dashboard and select "**[User settings](https://app.documenso.com/settings)**" from the dropdown menu.
 
 ![A screenshot of the Documenso's dashboard that shows the dropdown menu when you click on your user avatar](/webhook-images/dashboard-user-dropdown-menu.webp)
 
-Then, navigate to the "**Webhooks**" tab, where you can see a list of your existing webhooks and create new ones.
+Then, navigate to the "**[Webhooks](https://app.documenso.com/settings/webhooks)**" tab, where you can see a list of your existing webhooks and create new ones.
 
 ![A screenshot of the Documenso's user settings page that shows the Webhooks tab and the Create Webhook button](/webhook-images/webhooks-settings-page.webp)