Fixes in API-reference page (#1763)

This commit is contained in:
Dev Khant
2024-08-27 23:01:33 +05:30
committed by GitHub
parent 06d6fe7d76
commit a279ed0694
3 changed files with 1611 additions and 1483 deletions

View File

@@ -1,4 +1,4 @@
---
title: 'Delete User'
openapi: delete /entities/{entity_type}/{entity_id}/
openapi: delete /v1/entities/{entity_type}/{entity_id}/
---

View File

@@ -1,4 +1,4 @@
---
title: 'Get Users'
openapi: get /entities/
openapi: get /v1/entities/
---

View File

@@ -18,7 +18,9 @@
],
"security": [
{
"Basic":[]
"ApiKeyAuth": [
]
}
],
"paths": {
@@ -169,6 +171,7 @@
"200": {
"description": "",
"content": {
}
}
}
@@ -184,6 +187,7 @@
"200": {
"description": "",
"content": {
}
}
}
@@ -193,16 +197,32 @@
"entities"
],
"operationId": "entities_delete",
"requestBody":{
"content":{
"application/json":{
"parameters": [
{
"name": "entity_type",
"in": "path",
"required": true,
"schema": {
"$ref":"#/components/schemas/EntityInput"
}
}
"type": "string",
"enum": [
"user",
"agent",
"app",
"run"
]
},
"required":true
"description": "The type of the entity (user, agent, app, or run)"
},
{
"name": "entity_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "The unique identifier of the entity"
}
],
"responses": {
"204": {
"description": "Entity deleted successfully!",
@@ -235,6 +255,7 @@
"200": {
"description": "",
"content": {
}
}
}
@@ -247,6 +268,50 @@
],
"description": "Get all memories",
"operationId": "memories_list",
"parameters": [
{
"name": "user_id",
"in": "query",
"schema": {
"type": "string"
},
"description": "Filter memories by user ID"
},
{
"name": "agent_id",
"in": "query",
"schema": {
"type": "string"
},
"description": "Filter memories by agent ID"
},
{
"name": "app_id",
"in": "query",
"schema": {
"type": "string"
},
"description": "Filter memories by app ID"
},
{
"name": "run_id",
"in": "query",
"schema": {
"type": "string"
},
"description": "Filter memories by run ID"
},
{
"name": "metadata",
"in": "query",
"schema": {
"type": "object"
},
"description": "Filter memories by metadata (JSON string)",
"style": "deepObject",
"explode": true
}
],
"responses": {
"200": {
"description": "",
@@ -305,6 +370,22 @@
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "One of the filters: app_id, user_id, agent_id, run_id is required!"
}
}
}
}
}
}
}
},
@@ -370,16 +451,50 @@
],
"description": "Delete memories",
"operationId": "memories_delete",
"requestBody":{
"content":{
"application/json":{
"parameters": [
{
"name": "user_id",
"in": "query",
"schema": {
"$ref":"#/components/schemas/DeleteMemoriesInput"
}
}
"type": "string"
},
"required":true
"description": "Filter memories by user ID"
},
{
"name": "agent_id",
"in": "query",
"schema": {
"type": "string"
},
"description": "Filter memories by agent ID"
},
{
"name": "app_id",
"in": "query",
"schema": {
"type": "string"
},
"description": "Filter memories by app ID"
},
{
"name": "run_id",
"in": "query",
"schema": {
"type": "string"
},
"description": "Filter memories by run ID"
},
{
"name": "metadata",
"in": "query",
"schema": {
"type": "object"
},
"description": "Filter memories by metadata (JSON string)",
"style": "deepObject",
"explode": true
}
],
"responses": {
"204": {
"description": "Successful deletion of memories",
@@ -410,6 +525,7 @@
"200": {
"description": "",
"content": {
}
}
}
@@ -647,6 +763,7 @@
"200": {
"description": "",
"content": {
}
}
}
@@ -677,16 +794,18 @@
],
"description": "Get a memory.",
"operationId": "memories_read",
"requestBody":{
"content":{
"application/json":{
"parameters": [
{
"name": "memory_id",
"in": "path",
"required": true,
"schema": {
"$ref":"#/components/schemas/GetMemoryInput"
}
}
},
"required":true
"type": "string",
"format": "uuid"
},
"description": "The unique identifier of the memory to retrieve"
}
],
"responses": {
"200": {
"description": "Successfully retrieved the memory",
@@ -770,16 +889,18 @@
],
"description": "Get or Update or delete a memory.",
"operationId": "memories_update",
"requestBody":{
"content":{
"application/json":{
"parameters": [
{
"name": "memory_id",
"in": "path",
"required": true,
"schema": {
"$ref":"#/components/schemas/UpdateMemoryInput"
}
}
},
"required":true
"type": "string",
"format": "uuid"
},
"description": "The unique identifier of the memory to retrieve"
}
],
"responses": {
"200": {
"description": "Successfully updated memory",
@@ -849,16 +970,18 @@
],
"description": "Get or Update or delete a memory.",
"operationId": "memories_delete",
"requestBody":{
"content":{
"application/json":{
"parameters": [
{
"name": "memory_id",
"in": "path",
"required": true,
"schema": {
"$ref":"#/components/schemas/GetMemoryInput"
}
}
},
"required":true
"type": "string",
"format": "uuid"
},
"description": "The unique identifier of the memory to retrieve"
}
],
"responses": {
"204": {
"description": "Successful deletion of memory",
@@ -886,16 +1009,18 @@
],
"description": "Retrieve the history of a memory.",
"operationId": "memories_history_list",
"requestBody":{
"content":{
"application/json":{
"parameters": [
{
"name": "memory_id",
"in": "path",
"required": true,
"schema": {
"$ref":"#/components/schemas/GetMemoryInput"
}
}
},
"required":true
"type": "string",
"format": "uuid"
},
"description": "The unique identifier of the memory to retrieve"
}
],
"responses": {
"200": {
"description": "Successfully retrieved the memory history",
@@ -1041,6 +1166,7 @@
"200": {
"description": "",
"content": {
}
}
}
@@ -1472,9 +1598,11 @@
}
},
"securitySchemes": {
"Basic":{
"type":"http",
"scheme":"basic"
"ApiKeyAuth": {
"type": "apiKey",
"in": "header",
"name": "Authorization",
"description": "API key authentication. Prefix your Mem0 API key with 'Token '. Example: 'Token your_api_key'"
}
}
},