From c91ada05398454d952315206d2aff9b5462737f6 Mon Sep 17 00:00:00 2001
From: Chris Lu <chrislusf@users.noreply.github.com>
Date: Mon, 9 Nov 2020 01:19:39 -0800
Subject: [PATCH] Updated Filer Server API (markdown)

---
 Filer-Server-API.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/Filer-Server-API.md b/Filer-Server-API.md
index ac7e4a9..4e7a1b9 100644
--- a/Filer-Server-API.md
+++ b/Filer-Server-API.md
@@ -104,6 +104,30 @@ curl -H "Accept: application/json" "http://localhost:8888/javascript/?pretty=y"
 }
 ```
 
+### PUT/DELETE file tagging
+
+```
+# put 2 pairs of meta data
+curl -X PUT -H "Seaweed-Name1: value1" -H "Seaweed-some: some string value" http://localhost:8888/path/to/a/file?tagging
+
+# read the meta data from HEAD request
+curl -I "http://localhost:8888/path/to/a/file"
+...
+Seaweed-Name1: value1
+Seaweed-Some: some string value
+...
+
+# delete all "Seaweed-" prefixed meta data
+curl -X DELETE http://localhost:8888/path/to/a/file?tagging
+
+```
+
+| Method | Request | Header | Operation |
+| ---- | ---- | -- | -- |
+| PUT | <file_url>?tagging | Prefixed with "Seaweed-" | set the meta data  |
+| DELETE | <file_url>?tagging |  | remove all the "Seaweed-" prefixed header  |
+
+
 ### Create an empty folder
 
 Folders usually are created automatically when uploading a file. To create an empty file, you can use this: