From 035139d3883da1f4ff584e6120865064d3879788 Mon Sep 17 00:00:00 2001
From: Hypolite Petovan <hypolite@mrpetovan.com>
Date: Sun, 16 Feb 2020 12:09:07 -0500
Subject: [PATCH] Add documentation for api/friendica/events endpoint

---
 doc/API-Entities.md  | 117 +++++++++++++++++++++++++++++++++++++++++++
 doc/API-Friendica.md |   9 ++++
 2 files changed, 126 insertions(+)

diff --git a/doc/API-Entities.md b/doc/API-Entities.md
index b234912acd..e369cb4ffd 100644
--- a/doc/API-Entities.md
+++ b/doc/API-Entities.md
@@ -361,6 +361,123 @@ Ex: Wed May 23 06:01:13 +0000 2007
 </tbody>
 </table>
 
+## Event
+
+<table class="table table-condensed table-striped table-bordered">
+<thead>
+<tr>
+<th>Attribute</th>
+<th>Type</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><code>id</code></td>
+<td>Integer</td>
+<td></td>
+</tr>
+
+<tr>
+<td><code>uid</code></td>
+<td>Integer</td>
+<td>Owner User Id</td>
+</tr>
+
+<tr>
+<td><code>cid</code></td>
+<td>Integer</td>
+<td>Target Contact Id</td>
+</tr>
+
+<tr>
+<td><code>uri</code></td>
+<td>String</td>
+<td>Item unique URI string</td>
+</tr>
+
+<tr>
+<td><code>name</code></td>
+<td>String (Plaintext)</td>
+<td>Title</td>
+</tr>
+
+<tr>
+<td><code>desc</code></td>
+<td>String (HTML)</td>
+<td>Description</td>
+</tr>
+
+<tr>
+<td><code>startTime</code></td>
+<td>String (UTC <code>YYYY-MM-DD HH:II:SS)</code>)</td>
+<td></td>
+</tr>
+
+<tr>
+<td><code>endTime</code></td>
+<td>String (UTC <code>YYYY-MM-DD HH:II:SS)</code>)</td>
+<td>Optional (null date is <code>0001-01-01 00:00:00</code></td>
+</tr>
+
+<tr>
+<td><code>type</code></td>
+<td>String (<code>event</code> or <code>birthday</code>)</td>
+<td></td>
+</tr>
+
+<tr>
+<td><code>nofinish</code></td>
+<td>Boolean</td>
+<td>Ongoing event</td>
+</tr>
+
+<tr>
+<td><code>place</code></td>
+<td>String</td>
+<td>Optional. Location.</td>
+</tr>
+
+<tr>
+<td><code>adjust</code></td>
+<td>Boolean</td>
+<td>???</td>
+</tr>
+
+<tr>
+<td><code>ignore</code></td>
+<td>Boolean</td>
+<td>???</td>
+</tr>
+
+<tr>
+<td><code>allow_cid</code></td>
+<td>String (angle-brackets escaped integers)</td>
+<td>Optional. List of allowed contact ids</td>
+</tr>
+
+<tr>
+<td><code>allow_gid</code></td>
+<td>String (angle-brackets escaped integers)</td>
+<td>Optional. List of allowed group ids</td>
+</tr>
+
+<tr>
+<td><code>deny_cid</code></td>
+<td>String (angle-brackets escaped integers)</td>
+<td>Optional. List of disallowed contact ids</td>
+</tr>
+
+<tr>
+<td><code>deny_gid</code></td>
+<td>String (angle-brackets escaped integers)</td>
+<td>Optional. List of disallowed group ids</td>
+</tr>
+
+</tbody>
+</table>
+
 ## Hashtag
 
 Unused
diff --git a/doc/API-Friendica.md b/doc/API-Friendica.md
index 013dd08f59..62a71dc6b1 100644
--- a/doc/API-Friendica.md
+++ b/doc/API-Friendica.md
@@ -15,6 +15,15 @@ These endpoints uses the [Friendica API entities](help/API-Entities).
 
 ## Endpoints
 
+### GET api/friendica/events
+
+Returns a list of [Event](help/API-Entities#Event) entities for the current logged in user.
+
+#### Parameters
+
+- `since_id`: (optional) minimum event id for pagination
+- `count`: maximum number of items returned, default 20
+
 ### GET api/externalprofile/show
 
 Returns a [Contact](help/API-Entities#Contact) entity for the provided profile URL.