Add rest-api example (#889)

docs/api-reference/add-datasource-to-an-app.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /{app_id}/add
+---

docs/api-reference/chat-with-an-app.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /{app_id}/chat
+---

docs/api-reference/check-status.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /ping
+---

docs/api-reference/create-app.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /create
+---

docs/api-reference/delete-app.mdx

@@ -0,0 +1,3 @@
+---
+openapi: delete /{app_id}/delete
+---

docs/api-reference/deploy-app.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /{app_id}/deploy
+---

docs/api-reference/get-all-apps.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /apps
+---

docs/api-reference/get-datasources-associated-with-app-id.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /{app_id}/data
+---

docs/api-reference/getting-started.mdx

@@ -0,0 +1,102 @@
+---
+title: "🌍 Getting Started"
+---
+
+## Quick Start
+
+To run Embedchain as a REST API server use,
+
+```bash
+docker run -d --name embedchain -p 8000:8000 embedchain/app:rest-api-latest
+```
+
+Open up your browser and navigate to http://0.0.0.0:8000/docs to interact with the API. There is a full-fledged Swagger docs playground with all the information
+about the API endpoints.
+
+![Swagger Docs Screenshot](https://github.com/embedchain/embedchain/assets/73601258/299d81e5-a0df-407c-afc2-6fa2c4286844)
+
+## Creating your first App
+
+App requires an `app_id` to be created. The `app_id` is a unique identifier for your app.
+
+By default we will use the opensource **gpt4all** model to perform operations. You can also specify your own config by uploading a config YAML file.
+
+For example, create a `config.yaml` file (adjust according to your requirements):
+
+```yaml
+app:
+  config:
+    id: "default-app"
+
+llm:
+  provider: openai
+  config:
+    model: "gpt-3.5-turbo"
+    temperature: 0.5
+    max_tokens: 1000
+    top_p: 1
+    stream: false
+    template: |
+      Use the following pieces of context to answer the query at the end.
+      If you don't know the answer, just say that you don't know, don't try to make up an answer.
+
+      $context
+
+      Query: $query
+
+      Helpful Answer:
+
+vectordb:
+  provider: chroma
+  config:
+    collection_name: "rest-api-app"
+    dir: db
+    allow_reset: true
+
+embedder:
+  provider: openai
+  config:
+    model: "text-embedding-ada-002"
+```
+
+To learn more about custom configurations, check out the [Custom configurations](https://docs.embedchain.ai/advanced/configuration).
+To explore more examples of config YAMLs for Embedchain, visit [embedchain/configs](https://github.com/embedchain/embedchain/tree/main/configs).
+
+Now, you can upload this config file in the request body.
+
+**Note:** To use custom models, an **API key** might be required. Refer to the table below to determine the necessary API key for your provider.
+
+| Keys                       | Providers                      |
+| -------------------------- | ------------------------------ |
+| `OPENAI_API_KEY `          | OpenAI, Azure OpenAI, Jina etc |
+| `OPENAI_API_TYPE`          | Azure OpenAI                   |
+| `OPENAI_API_BASE`          | Azure OpenAI                   |
+| `OPENAI_API_VERSION`       | Azure OpenAI                   |
+| `COHERE_API_KEY`           | Cohere                         |
+| `ANTHROPIC_API_KEY`        | Anthropic                      |
+| `JINACHAT_API_KEY`         | Jina                           |
+| `HUGGINGFACE_ACCESS_TOKEN` | Huggingface                    |
+| `REPLICATE_API_TOKEN`      | LLAMA2                         |
+
+To provide them, you can simply run the docker command with the `-e` flag.
+
+For example,
+
+```bash
+docker run -d --name embedchain -p 8000:8000 -e OPENAI_API_KEY=YOUR_API_KEY embedchain/app:rest-api-latest
+```
+
+Cool! This will create a new Embedchain App with the given `app_id`.
+
+## Deploying your App to Embedchain Platform
+
+This feature is very powerful as it allows the creation of a public API endpoint for your app, enabling queries from anywhere. This creates a _pipeline_
+for your app that can sync the data time to time and provide you with the best results.
+
+![My first Pipeline](https://github.com/embedchain/embedchain/assets/73601258/266a66e0-330e-4bb9-aa97-687d826cd3fa)
+
+To utilize this functionality, visit app.embedchain.ai and create an account. Subsequently, generate a new [API KEY](https://app.embedchain.ai/settings/keys/).
+
+![Create Embedchain API Key](https://github.com/embedchain/embedchain/assets/73601258/791e92cc-4a6f-4740-94c2-f11cce13e93b)
+
+Using this API key, you can deploy your app to the platform.

docs/api-reference/query-an-app.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /{app_id}/query
+---