docs(openapi): document limit param and error responses on GET /v1/memories/ (#6779)
This commit is contained in:
+57
-2
@@ -1218,6 +1218,15 @@
|
||||
},
|
||||
"description": "Number of items per page. Default: 100."
|
||||
},
|
||||
{
|
||||
"name": "limit",
|
||||
"in": "query",
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"maximum": 200
|
||||
},
|
||||
"description": "Maximum number of memories to return. Maximum accepted value: 200. Ignored when both `page` and `page_size` are supplied."
|
||||
},
|
||||
{
|
||||
"name": "start_date",
|
||||
"in": "query",
|
||||
@@ -1261,6 +1270,7 @@
|
||||
},
|
||||
"metadata": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "User-supplied metadata attached to the memory."
|
||||
},
|
||||
@@ -1288,6 +1298,7 @@
|
||||
},
|
||||
"structured_attributes": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "System-derived temporal breakdown of the memory's creation time (e.g. year, month, day_of_week)."
|
||||
},
|
||||
@@ -1346,6 +1357,7 @@
|
||||
},
|
||||
"metadata": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "User-supplied metadata attached to the memory."
|
||||
},
|
||||
@@ -1373,6 +1385,7 @@
|
||||
},
|
||||
"structured_attributes": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "System-derived temporal breakdown of the memory's creation time (e.g. year, month, day_of_week)."
|
||||
},
|
||||
@@ -1413,14 +1426,47 @@
|
||||
},
|
||||
"400": {
|
||||
"description": "Bad Request.",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"oneOf": [
|
||||
{
|
||||
"type": "array",
|
||||
"description": "Returned when none of the required filters (app_id, user_id, agent_id, run_id) is supplied.",
|
||||
"items": {
|
||||
"type": "string"
|
||||
},
|
||||
"example": [
|
||||
"One of the filters: app_id, user_id, agent_id, run_id is required!"
|
||||
]
|
||||
},
|
||||
{
|
||||
"type": "object",
|
||||
"description": "Returned when the `limit` query parameter is invalid.",
|
||||
"properties": {
|
||||
"error": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"example": {
|
||||
"error": "limit must be <= 200"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"404": {
|
||||
"description": "Not Found.",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"message": {
|
||||
"detail": {
|
||||
"type": "string",
|
||||
"example": "One of the filters: app_id, user_id, agent_id, run_id is required!"
|
||||
"example": "Invalid page."
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1774,6 +1820,7 @@
|
||||
},
|
||||
"metadata": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "Additional metadata associated with the memory"
|
||||
},
|
||||
@@ -1802,6 +1849,7 @@
|
||||
},
|
||||
"structured_attributes": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "System-derived temporal breakdown of the memory's creation time (e.g. year, month, day_of_week)."
|
||||
},
|
||||
@@ -2563,6 +2611,7 @@
|
||||
},
|
||||
"metadata": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "User-supplied metadata attached to the memory."
|
||||
},
|
||||
@@ -2575,6 +2624,7 @@
|
||||
},
|
||||
"structured_attributes": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "System-derived temporal breakdown of the memory's creation time (e.g. year, month, day_of_week)."
|
||||
},
|
||||
@@ -3082,6 +3132,7 @@
|
||||
},
|
||||
"metadata": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "User-supplied metadata attached to the memory."
|
||||
},
|
||||
@@ -3380,6 +3431,7 @@
|
||||
},
|
||||
"metadata": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "Additional metadata associated with the memory"
|
||||
},
|
||||
@@ -3408,6 +3460,7 @@
|
||||
},
|
||||
"structured_attributes": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "System-derived temporal breakdown of the memory's creation time (e.g. year, month, day_of_week)."
|
||||
},
|
||||
@@ -3571,6 +3624,7 @@
|
||||
},
|
||||
"metadata": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "Additional metadata associated with the memory"
|
||||
},
|
||||
@@ -3599,6 +3653,7 @@
|
||||
},
|
||||
"structured_attributes": {
|
||||
"type": "object",
|
||||
"nullable": true,
|
||||
"additionalProperties": true,
|
||||
"description": "System-derived temporal breakdown of the memory's creation time (e.g. year, month, day_of_week)."
|
||||
},
|
||||
|
||||
Reference in New Issue
Block a user