From c74ea7282aa2908a71e02c12045cf08e0abed513 Mon Sep 17 00:00:00 2001
From: Jason Rasmussen <jrasm91@gmail.com>
Date: Mon, 6 Nov 2023 09:08:36 -0500
Subject: [PATCH] docs: python upload guide (#4867)

---
 docs/docs/guides/python-file-upload.md | 42 ++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 docs/docs/guides/python-file-upload.md

diff --git a/docs/docs/guides/python-file-upload.md b/docs/docs/guides/python-file-upload.md
new file mode 100644
index 0000000000..dc1be79e06
--- /dev/null
+++ b/docs/docs/guides/python-file-upload.md
@@ -0,0 +1,42 @@
+# Python File Upload
+
+```python
+#!/usr/bin/python3
+
+import requests
+import os
+from datetime import datetime
+
+API_KEY = 'YOUR_API_KEY'                # replace with a valid api key
+BASE_URL = 'http://127.0.0.1:2283/api'  # replace as needed
+
+
+def upload(file):
+    stats = os.stat(file)
+
+    headers = {
+        'Accept': 'application/json',
+        'x-api-key': API_KEY
+    }
+
+    data = {
+        'deviceAssetId': f'{file}-{stats.st_mtime}',
+        'deviceId': 'python',
+        'fileCreatedAt': datetime.fromtimestamp(stats.st_mtime),
+        'fileModifiedAt': datetime.fromtimestamp(stats.st_mtime),
+        'isFavorite': 'false',
+    }
+
+    files = {
+        'assetData': open(file, 'rb')
+    }
+
+    response = requests.post(
+        f'{BASE_URL}/asset/upload', headers=headers, data=data, files=files)
+
+    print(response.json())
+    # {'id': 'ef96f635-61c7-4639-9e60-61a11c4bbfba', 'duplicate': False}
+
+
+upload('./test.jpg')
+```