Update docs to be better.

Author: Samuel P

content/_index.md

@@ -46,6 +46,6 @@ curl https://app.tryhelix.ai/api/v1/sessions \
 
 Get your API key from [Account](https://app.tryhelix.ai/account) page in the app.
 
-[Full API reference]({{< ref "/helix/api.md" >}})
+[Full API reference]({{< ref "/helix/api-reference/_index.md" >}})
 {{% /index/cta-right %}}
 {{< /index/cta >}}

content/helix/api-reference/_index.md

@@ -0,0 +1,36 @@
+---
+title: API Reference
+weight: 8
+prev: /helix/private-deployment/_index.md
+aliases:
+  - /docs/api
+---
+
+The REST API is the fundamental fabric of Helix. All operations and communications between components, and external user commands are REST API calls that the Control Plane handles.For general background information, get familiar with the [Helix architecture](https://docs.helix.ml/helix/getting-started/architecture/) and the components involved.
+
+With Helix's API, you can access a wide range of features, including natural language processing, machine learning models, data analysis, and more. Here's how to get started:
+
+1. **API Key and Authentication**: First, sign up on [Helix](https://app.tryhelix.ai/) and obtain your API key from the [Account section](https://app.tryhelix.ai/account). The API key is required to authenticate your requests and ensure secure communication between your application and Helix.
+
+All API requests should include your API key in an Authorization HTTP header as follows:
+
+```
+Authorization: Bearer Helix_API_KEY
+```
+
+2. **Making Requests**: Use HTTP methods like GET, POST, PUT, and DELETE to interact with the API. Depending on the feature you're utilizing, you may need to send JSON data, files, or other inputs in your requests.
+
+3. **Handling Responses**: The API will return responses in JSON format, containing the results of your request, status codes, and any relevant error messages. Properly handle these responses in your application to ensure smooth operation.
+
+
+## More Information
+
+Get your API key from [Account](https://app.tryhelix.ai/account) page in the app.
+
+For the rest of the endpoints, see the generated [OpenAPI Spec](https://github.com/helixml/helix/blob/main/api/pkg/server/swagger.yaml) or the [code](https://github.com/helixml/helix/blob/main/api/pkg/server/server.go#L81-L215).
+
+Please encourage us to write more on this on [Discord](https://discord.gg/VJftd844GE)!
+
+<!--more-->
+
+{{< default-section-cards-list >}}

content/helix/api-reference/apps.md

@@ -0,0 +1,45 @@
+---
+title: Sessions
+weight: 1
+prev: /helix/api-reference/_index.md
+aliases:
+  - /docs/sessions
+---
+
+An Helix session object is a structured data entity used to represent and manage the state, context, and interactions during a conversation between a user and an the Helix system. This object typically contains information necessary to maintain the continuity of the dialogue, track user inputs, and store any relevant context or variables that might influence the responses. All sessions are identified by a unique session ID.
+
+## Explore Session metadata
+
+Create a chat session on [Helix](https://app.tryhelix.ai/session/ses_01j56vxhjn6qh23hecxdan147a) and grab the session id from the browser URL.
+
+```shell
+curl 'https://app.tryhelix.ai/api/v1/sessions/<SESSION_ID>' \
+  -H 'Authorization: Bearer <YOUR_API_KEY>' \
+  --compressed
+```
+
+The response will show all of details of a session.
+
+```json
+{
+    "id": "ses_testnan1brx876npc23",
+    "name": "magical-chat-815",
+    "parent_session": "",
+    "parent_app": "",
+    "config": {
+        ...
+    },
+    "mode": "inference",
+    "type": "image",
+    "model_name": "stabilityai/stable-diffusion-xl-base-1.0",
+    "lora_dir": "",
+    "interactions": [
+        {
+            ...
+        },
+    ]
+}
+
+```
+
+The [Helix Open API Spec](https://github.com/helixml/helix/blob/main/api/pkg/server/swagger.yaml) details the session request and response objects.

content/helix/api-reference/openai.md

@@ -0,0 +1,93 @@
+---
+title: Chat Session
+weight: 1
+prev: /helix/api-reference/sessions/_index.md
+aliases:
+  - /docs/chat-session
+---
+
+## Create an inference session
+
+An *inference session* is when a trained machine learning model is used to make predictions or decisions based on new data. Unlike training, which involves learning from data, inference applies the learned model to real-world inputs to produce outputs. Helix offers various [AI models](https://docs.helix.ml/helix/models/models/) which can be used for inference.
+
+##### Example Request and Response
+
+```shell
+curl https://app.tryhelix.ai/api/v1/sessions \
+  -H 'Authorization: Bearer <YOUR_API_KEY>'
+  -d "input=yo&mode=inference&type=text"
+```
+
+will respond with
+
+```json
+{
+    "created": 1723155364,
+    "object": "chat.completion",
+    "id": "ses_01a4t10cysc825d3k037tyh7ap",
+    "model": "llama3:instruct",
+    "choices": [
+        {
+            "index": 0,
+            "finish_reason": "stop",
+            "message": {
+                "role": "assistant",
+                "content": "The Faroe Islands (Føroyar in Faroese) are a North Atlantic archipelago located halfway between Iceland and Norway."
+            }
+        }
+    ],
+    "usage": {
+        "prompt_tokens": 0,
+        "completion_tokens": 168,
+        "total_tokens": 168
+    }
+}
+```
+
+##### HTTP Request
+
+```
+POST https://app.tryhelix.ai/api/v1/sessions/chat
+```
+
+##### Parameters
+Request body with the message and model to start chat completion.
+
+```json
+{
+  "app_id": "string",
+  "assistant_id": "string",
+  "legacy": true,
+  "lora_dir": "string",
+  "lora_id": "string",
+  "messages": [
+    {
+      "content": {
+        "content_type": "text",
+        "parts": [
+          "string"
+        ]
+      },
+      "created_at": "string",
+      "id": "string",
+      "role": "system",
+      "state": "",
+      "updated_at": "string"
+    }
+  ],
+  "model": "string",
+  "rag_source_id": "string",
+  "session_id": "string",
+  "stream": true,
+  "system": "string",
+  "tools": [
+    "string"
+  ],
+  "type": "text"
+}
+```
+
+`"type":"image|chat"`
+
+Switching over the `"type":"image"` will start a session with model `stabilityai/stable-diffusion-xl-base-1.0` that generates an image.
+

content/helix/api-reference/sessions/_index.md

@@ -1,30 +1,13 @@
 ---
-title: API Reference
-weight: 8
-prev: /helix/private-deployment/_index.md
+title: Fine Tuning Session
+weight: 1
+prev: /helix/api-reference/sessions/chat-sessions.md
 aliases:
-  - /docs/api
+  - /docs/fine-tuning-session
 ---
 
-## Easy to use API
 
-Create a new chat session:
-
-```shell
-curl https://app.tryhelix.ai/api/v1/sessions \
-  -H 'Authorization: Bearer <YOUR_API_KEY>'
-  -d "input=yo&mode=inference&type=text"
-```
-
-Generate an image:
-
-```shell
-curl https://app.tryhelix.ai/api/v1/sessions \
-  -H 'Authorization: Bearer <YOUR_API_KEY>'
-  -d "input=flying fish&mode=inference&type=image"
-```
-
-### Create a Text Fine-Tuning Session
+## Create a Text Fine-Tuning Session
 
 First create a file that will be used to upload the text data. It should be in [`multipart/form-data` format](https://www.rfc-editor.org/rfc/rfc7578). The form data keys `mode` and `type` are required to distinguish that this is a text fine-tuning session.
 
@@ -55,14 +38,14 @@ EOL
 Now `POST` that file to Helix to create a new fine-tuning session.
 
 ```shell
-curl 'https://app.tryhelix.ai/api/v1/sessions' \
+curl 'https://app.tryhelix.ai/api/v1/sessions/learn' \
   -H 'Authorization: Bearer <YOUR_API_KEY>' \
   -H 'Content-Type: multipart/form-data; boundary=---BOUNDARY' \
   --data-binary @session-data.form \
   --compressed
 ```
-
-#### Check on the Status of a Fine-Tune Session
+.
+## Check on the Status of a Fine-Tune Session
 
 First grab the ID of your session from the `id` field of the output of the create session API. Then run:
 
@@ -75,11 +58,3 @@ curl 'https://app.tryhelix.ai/api/v1/sessions/<SESSION_ID>' \
 The response will show all of the generated QA pairs for the fine-tune session as well as the status of the session.
 
 Look at the `interactions` key to find the current state.
-
-## More Information
-
-Get your API key from [Account](https://app.tryhelix.ai/account) page in the app.
-
-For the rest of the endpoints, see the [code](https://github.com/helixml/helix/blob/main/api/pkg/server/server.go#L81-L215).
-
-Please encourage us to write more on this on [Discord](https://discord.gg/VJftd844GE)!

content/helix/api-reference/sessions/chat-session.md

@@ -20,6 +20,7 @@
       "h2",
       "h3",
       "h4",
+      "h5",
       "head",
       "html",
       "iframe",
@@ -401,6 +402,7 @@
       "ltr:hx-ml-3",
       "ltr:hx-ml-auto",
       "ltr:hx-mr-auto",
+      "ltr:hx-pl-12",
       "ltr:hx-pl-3",
       "ltr:hx-pl-4",
       "ltr:hx-pl-8",
@@ -476,6 +478,7 @@
       "rtl:hx-mr-3",
       "rtl:hx-mr-auto",
       "rtl:hx-pl-4",
+      "rtl:hx-pr-12",
       "rtl:hx-pr-3",
       "rtl:hx-pr-4",
       "rtl:hx-pr-8",
@@ -561,6 +564,7 @@
       "business-prompts",
       "can-i-integrate-my-models-with-my-own-apps-or-business-apps-once-ive-got-it-working",
       "check-on-the-status-of-a-fine-tune-session",
+      "check-the-status-of-a-session",
       "clone-repo-and-set-up-env-file",
       "come-talk-to-us",
       "components",
@@ -570,6 +574,8 @@
       "control-plane-environment-variables",
       "control-plane-interaction",
       "create-a-text-fine-tuning-session",
+      "create-an-inference-session",
+      "create-inference-sessions",
       "creating-a-bot",
       "creating-a-website",
       "creating-the-api-tool-in-helix",
@@ -578,15 +584,16 @@
       "deleting-a-bot",
       "deleting-a-website",
       "deployment-on-docker-compose",
-      "easy-to-use-api",
       "embedding-the-helix-chat-widget-in-your-react-app",
       "embedding-the-helix-chat-widget-in-your-web-page",
       "enabling-helix-apps",
       "example",
       "example-gptscript",
       "example-helixyaml",
       "example-javascript-code",
+      "example-request-and-response",
       "example-sessions",
+      "explore-session-metadata",
       "good-prompts-to-try-for-mistral-7b-chatgpt-alternative",
       "good-prompts-to-try-for-sdxl-stable-diffusion-xl",
       "gptscript-tips",
@@ -606,6 +613,7 @@
       "how-helix-works",
       "how-to-create-a-basic-app",
       "how-to-use-this-documentation",
+      "http-request",
       "image-models",
       "important-notes",
       "inference-best-practices",
@@ -622,6 +630,7 @@
       "now-lets-fine-tune-a-text-model",
       "now-lets-fine-tune-an-image-model",
       "overriding-query-parameters",
+      "parameters",
       "preview",
       "prompt-execution",
       "props",
@@ -636,6 +645,7 @@
       "runners",
       "saving-and-canceling",
       "search-theme-options",
+      "session-data",
       "setup-helix",
       "setup-keycloak",
       "share-results",