From 4cc0f65a0b285788073164a2bf6c4dd5d1031db7 Mon Sep 17 00:00:00 2001
From: Dominik Werder <dominik.werder@gmail.com>
Date: Tue, 3 Sep 2024 22:13:28 +0200
Subject: [PATCH] Add pulsemap doc

---
 apidoc/src/pulsemap.md | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 apidoc/src/pulsemap.md

diff --git a/apidoc/src/pulsemap.md b/apidoc/src/pulsemap.md
new file mode 100644
index 0000000..245dc0d
--- /dev/null
+++ b/apidoc/src/pulsemap.md
@@ -0,0 +1,11 @@
+# Map Pulse to Timestamp
+
+For SwissFEL, pulse-ids can be mapped to timestamps:
+
+```bash
+curl "https://data-api.psi.ch/api/4/map/pulse/sf-databuffer/PULSEID"
+```
+
+If the pulse can not be found, it returns http status 204.
+
+If the pulse and the corresponding timestamp was found, it returns the normal status 200.