From af1f4e7971a8cf3d309835160b172a35e75f228c Mon Sep 17 00:00:00 2001
From: Nicholas Wallace <nicholaslwallace@gmail.com>
Date: Fri, 11 Oct 2024 19:26:16 -0700
Subject: [PATCH] Add: cache clearing

---
 docs/newRoot.yaml | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/docs/newRoot.yaml b/docs/newRoot.yaml
index 8108fb813..7d2f30764 100644
--- a/docs/newRoot.yaml
+++ b/docs/newRoot.yaml
@@ -6031,3 +6031,39 @@ paths:
                           example: 11111
         '400':
           $ref: '#/components/responses/badRequest'
+  /api/cache/purge-all:
+    post:
+      operationId: purgeAllCache
+      summary: Purge all cache
+      description: Purge all cache. This endpoint purges all cache entries under `metadata/cache`.
+      tags:
+        - Cache
+      responses:
+        '200':
+          description: OK
+          content:
+            text/plain:
+              schema:
+                type: string
+                example: 'Server cache purged.'
+        '403':
+          $ref: '#/components/responses/forbidden'
+  /api/cache/purge-items:
+    post:
+      operationId: purgeCacheItems
+      summary: Purge cache items
+      description: Purge cache items. This endpoint purges cache entries by key under `metadata/cache/items`.
+      tags:
+        - Cache
+      responses:
+        '200':
+          description: OK
+          content:
+            text/plain:
+              schema:
+                type: string
+                example: 'Item cache purged.'
+        '400':
+          $ref: '#/components/responses/badRequest'
+        '403':
+          $ref: '#/components/responses/forbidden'