feat(documentation): Init

documentation/README.md

@@ -0,0 +1,20 @@
+# Julep Mintlify Documentation
+
+## Development
+
+Install the [Mintlify CLI](https://www.npmjs.com/package/mintlify) to preview the documentation changes locally. To install, use the following command
+
+```
+npm i -g mintlify
+```
+
+Run the following command at the root of your documentation (where mint.json is)
+
+```
+mintlify dev
+```
+
+### Troubleshooting
+
+- Mintlify dev isn't running - Run `mintlify install` it'll re-install dependencies.
+- Page loads as a 404 - Make sure you are running in a folder with `mint.json`

documentation/api-reference/agents/create-or-update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /agents/{id}
+---

documentation/api-reference/agents/create.mdx

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

documentation/api-reference/agents/delete.mdx

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

documentation/api-reference/agents/get.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /agents/{id}
+---

documentation/api-reference/agents/list.mdx

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

documentation/api-reference/agents/patch.mdx

@@ -0,0 +1,3 @@
+---
+openapi: patch /agents/{id}
+---

documentation/api-reference/agents/tools/create.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /agents/{id}/tools
+---

documentation/api-reference/agents/tools/delete.mdx

@@ -0,0 +1,3 @@
+---
+openapi: delete /agents/{id}/tools/{child_id}
+---

documentation/api-reference/agents/tools/list.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /agents/{id}/tools
+---

documentation/api-reference/agents/tools/patch.mdx

@@ -0,0 +1,3 @@
+---
+openapi: patch /agents/{id}/tools/{child_id}
+---

documentation/api-reference/agents/tools/update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: put /agents/{id}/tools/{child_id}
+---

documentation/api-reference/agents/update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: put /agents/{id}
+---

documentation/api-reference/docs/agents/create.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /agents/{id}/docs
+--- 

documentation/api-reference/docs/agents/delete.mdx

@@ -0,0 +1,3 @@
+---
+openapi: delete /agents/{id}/docs/{child_id}
+--- 

documentation/api-reference/docs/agents/list.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /agents/{id}/docs
+--- 

documentation/api-reference/docs/agents/search.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /agents/{id}/search
+---

documentation/api-reference/docs/embed.mdx

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

documentation/api-reference/docs/get.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /docs/{id}
+---

documentation/api-reference/docs/users/create.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /users/{id}/docs
+--- 

documentation/api-reference/docs/users/delete.mdx

@@ -0,0 +1,3 @@
+---
+openapi: delete /users/{id}/docs/{child_id}
+--- 

documentation/api-reference/docs/users/list.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /users/{id}/docs
+--- 

documentation/api-reference/docs/users/search.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /users/{id}/search
+---

documentation/api-reference/executions/create.mdx

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

documentation/api-reference/executions/get.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /executions/{id}
+---

documentation/api-reference/executions/transitions-stream.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /executions/{id}/transitions.stream
+---

documentation/api-reference/executions/transitions.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /executions/{id}/transitions
+---

documentation/api-reference/executions/update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: put /executions/{id}
+---

documentation/api-reference/files/create.mdx

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

documentation/api-reference/files/get.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /files/{id}
+---

documentation/api-reference/introduction.mdx

@@ -0,0 +1,51 @@
+---
+title: Introduction
+description: 'Introduction to the Julep REST API'
+---
+
+<CardGroup cols={2}>
+  <Card
+    title="Agent Endpoints"
+    icon="robot"
+    href="/api-reference/agents/create"
+  >
+    Create, update, and manage AI agents
+  </Card>
+  <Card
+    title="Task Endpoints"
+    icon="list-check"
+    href="/api-reference/tasks/create"
+  >
+    Create and execute AI tasks and workflows
+  </Card>
+  <Card
+    title="Session Endpoints"
+    icon="comments"
+    href="/api-reference/sessions/create"
+  >
+    Manage conversation sessions and state
+  </Card>
+  <Card
+    title="User Endpoints"
+    icon="plug"
+    href="/api-reference/users/create"
+  >
+    Register and manage users
+  </Card>
+</CardGroup>
+
+## Authentication
+
+<Note>
+  Authentication is done via API keys.
+</Note>
+
+API keys are used to authenticate requests to the Julep API. They can be created in the [Julep dashboard](https://dashboard.julep.ai).
+
+To create an API key, go to the Julep dashboard and navigate to the "API Keys" section.
+
+To use an API key, include it in the `Authorization` header of your request.
+
+```
+Authorization: Bearer YOUR_API_KEY
+```

documentation/api-reference/jobs/get.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /jobs/{id}
+---

documentation/api-reference/sessions/chat.mdx

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

documentation/api-reference/sessions/create-or-update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /sessions/{id}
+---

documentation/api-reference/sessions/create.mdx

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

documentation/api-reference/sessions/delete.mdx

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

documentation/api-reference/sessions/get.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /sessions/{id}
+---

documentation/api-reference/sessions/history/delete.mdx

@@ -0,0 +1,3 @@
+---
+openapi: delete /sessions/{id}/history
+---

documentation/api-reference/sessions/history/get.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /sessions/{id}/history
+---

documentation/api-reference/sessions/list.mdx

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

documentation/api-reference/sessions/patch.mdx

@@ -0,0 +1,3 @@
+---
+openapi: patch /sessions/{id}
+---

documentation/api-reference/sessions/update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: put /sessions/{id}
+---

documentation/api-reference/tasks/create-or-update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /agents/{parent_id}/tasks/{id}
+---

documentation/api-reference/tasks/create.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /agents/{id}/tasks
+---

documentation/api-reference/tasks/delete.mdx

@@ -0,0 +1,3 @@
+---
+openapi: delete /agents/{id}/tasks/{child_id}
+---

documentation/api-reference/tasks/executions/create.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /tasks/{id}/executions
+---

documentation/api-reference/tasks/executions/list.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /tasks/{id}/executions
+---

documentation/api-reference/tasks/get.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /tasks/{id}
+---

documentation/api-reference/tasks/list.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /agents/{id}/tasks
+---

documentation/api-reference/tasks/patch.mdx

@@ -0,0 +1,3 @@
+---
+openapi: patch /agents/{id}/tasks/{child_id}
+---

documentation/api-reference/tasks/update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: put /agents/{id}/tasks/{child_id}
+---

documentation/api-reference/users/create-or-update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: post /users/{id}
+---

documentation/api-reference/users/create.mdx

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

documentation/api-reference/users/delete.mdx

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

documentation/api-reference/users/get.mdx

@@ -0,0 +1,3 @@
+---
+openapi: get /users/{id}
+---

documentation/api-reference/users/list.mdx

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

documentation/api-reference/users/patch.mdx

@@ -0,0 +1,3 @@
+---
+openapi: patch /users/{id}
+---

documentation/api-reference/users/update.mdx

@@ -0,0 +1,3 @@
+---
+openapi: put /users/{id}
+---