feat: 🎸 docs

added api doc
This commit is contained in:
Stan Girard 2023-12-25 16:08:28 +01:00
parent 74e1cac1a8
commit 4a7f162405
52 changed files with 289 additions and 5 deletions

View File

@ -0,0 +1,3 @@
---
openapi: post /api-key
---

View File

@ -0,0 +1,3 @@
---
openapi: delete /api-key/{key_id}
---

View File

@ -0,0 +1,3 @@
---
openapi: get /api-keys
---

View File

@ -0,0 +1,3 @@
---
openapi: post /brains/{brain_id}/subscription/accept
---

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: post /brains/{brain_id}/subscription/decline
---

View File

@ -0,0 +1,3 @@
---
openapi: post /brains/{brain_id}/documents
---

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: get /brains/{brain_id}/
---

View File

@ -0,0 +1,3 @@
---
openapi: get /brains/default/
---

View File

@ -0,0 +1,3 @@
---
openapi: get /brains/public
---

View File

@ -0,0 +1,3 @@
---
openapi: post /brains/{brain_id}/default
---

View File

@ -0,0 +1,3 @@
---
openapi: put /brains/{brain_id}/secrets-values
---

View File

@ -0,0 +1,3 @@
---
openapi: put /brains/{brain_id}/
---

View File

@ -0,0 +1,3 @@
---
openapi: get /brains/{brain_id}/subscription
---

View File

@ -0,0 +1,3 @@
---
openapi: post /brains/{brain_id}/subscription
---

View File

@ -0,0 +1,3 @@
---
openapi: post /chat/{chat_id}/question/answer
---

View File

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

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: post /chat/{chat_id}/question/stream
---

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: get /chat/{chat_id}/history
---

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: put /chat/{chat_id}/metadata
---

View File

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

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: get /crawl/healthz
---

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: get /upload/healthz
---

View File

@ -0,0 +1,3 @@
---
openapi: get /chat/healthz
---

View File

@ -0,0 +1,4 @@
---
title: 'Introduction'
description: 'Example section for showcasing API endpoints'
---

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: get /knowledge/{knowledge_id}/signed_download_url
---

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: get /notifications/{chat_id}
---

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: put /onboarding
---

View File

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

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: get /prompts/{prompt_id}
---

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: put /prompts/{prompt_id}
---

View File

@ -0,0 +1,3 @@
---
openapi: delete /brains/{brain_id}/subscription
---

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: post /brains/{brain_id}/subscribe
---

View File

@ -0,0 +1,3 @@
---
openapi: post /brains/{brain_id}/unsubscribe
---

View File

@ -0,0 +1,3 @@
---
openapi: put /brains/{brain_id}/subscription
---

View File

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

View File

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

View File

@ -0,0 +1,3 @@
---
openapi: get /user/identity
---

View File

@ -0,0 +1,3 @@
---
openapi: put /user/identity
---

View File

@ -3,12 +3,12 @@
"name": "Quivr",
"favicon": "/favicon.svg",
"colors": {
"primary": "#6142D4",
"light": "#F6F4FF",
"dark": "#13ABBA",
"primary": "#0D9373",
"light": "#07C983",
"dark": "#0D9373",
"anchors": {
"from": "#6142D4",
"to": "#F6F4FF"
"from": "#0D9373",
"to": "#07C983"
}
},
"topbarLinks": [
@ -25,6 +25,10 @@
{
"name": "Developer Guide",
"url": "developers"
},
{
"name": "API Reference",
"url": "api-reference"
}
],
"anchors": [
@ -99,6 +103,126 @@
]
}
]
},
{
"group": "API Reference",
"pages": [
{
"group": "Brain",
"pages": [
"api-reference/brain/retrieve-all-brains-for-user",
"api-reference/brain/create-new-brain",
"api-reference/brain/retrieve-public-brains",
"api-reference/brain/retrieve-default-brain",
"api-reference/brain/retrieve-brain-by-id",
"api-reference/brain/update-existing-brain",
"api-reference/brain/update-existing-brain-secrets",
"api-reference/brain/set-brain-as-default",
"api-reference/brain/get-question-context-for-brain",
"api-reference/brain/accept-invitation",
"api-reference/brain/decline-invitation"
]
},
{
"group": "Health",
"pages": [
"api-reference/health/healthz",
"api-reference/health/healthz-1",
"api-reference/health/healthz-2",
"api-reference/health/healthz-3"
]
},
{
"group": "Chat",
"pages": [
"api-reference/chat/get-chats",
"api-reference/chat/create-chat-handler",
"api-reference/chat/delete-chat",
"api-reference/chat/update-chat-metadata-handler",
"api-reference/chat/create-question-handler",
"api-reference/chat/create-stream-question-handler",
"api-reference/chat/get-chat-history-handler",
"api-reference/chat/add-question-and-answer-handler"
]
},
{
"group": "Crawl",
"pages": [
"api-reference/crawl/crawl-endpoint"
]
},
{
"group": "Onboarding",
"pages": [
"api-reference/onboarding/get-user-onboarding-handler",
"api-reference/onboarding/update-user-onboarding-handler"
]
},
"api-reference/root",
{
"group": "Upload",
"pages": [
"api-reference/upload/upload-file"
]
},
{
"group": "User",
"pages": [
"api-reference/user/get-user-endpoint",
"api-reference/user/get-user-identity-route",
"api-reference/user/update-user-identity-route"
]
},
{
"group": "API Key",
"pages": [
"api-reference/api-key/create-api-key",
"api-reference/api-key/delete-api-key",
"api-reference/api-key/get-api-keys"
]
},
{
"group": "BrainSubscription",
"pages": [
"api-reference/brainsubscription/get-user-invitation",
"api-reference/brainsubscription/invite-users-to-brain"
]
},
"api-reference/update-brain-subscription",
"api-reference/remove-user-subscription",
"api-reference/get-users-with-brain-access",
{
"group": "Subscription",
"pages": [
"api-reference/subscription/subscribe-to-brain-handler",
"api-reference/subscription/unsubscribe-from-brain-handler"
]
},
{
"group": "Prompt",
"pages": [
"api-reference/prompt/get-prompts",
"api-reference/prompt/create-prompt-route",
"api-reference/prompt/get-prompt",
"api-reference/prompt/update-prompt"
]
},
{
"group": "Notification",
"pages": [
"api-reference/notification/get-notifications"
]
},
{
"group": "Knowledge",
"pages": [
"api-reference/knowledge/list-knowledge-in-brain-endpoint",
"api-reference/knowledge/delete-endpoint",
"api-reference/knowledge/generate-signed-url-endpoint"
]
},
"api-reference/post-contact"
]
}
],
"footerSocials": {
@ -112,5 +236,11 @@
"thumbsRating": true,
"raiseIssue": true,
"suggestEdit": true
},
"api": {
"baseUrl": "https://api.quivr.app",
"auth": {
"method": "bearer"
}
}
}