From c115b4c2f4cfda43bdb6409edf9f14bfb8004151 Mon Sep 17 00:00:00 2001
From: Mark Haines <mark.haines@matrix.org>
Date: Mon, 28 Sep 2015 13:47:04 +0100
Subject: [PATCH] Document the valid values for the "set_presence" parameter

---
 api/client-server/v2_alpha/sync.yaml | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/api/client-server/v2_alpha/sync.yaml b/api/client-server/v2_alpha/sync.yaml
index e678d2d8..0fe9173d 100644
--- a/api/client-server/v2_alpha/sync.yaml
+++ b/api/client-server/v2_alpha/sync.yaml
@@ -43,9 +43,14 @@ paths:
         - in: query
           name: set_presence
           type: string
+          enum: ["offline"]
           description: |-
-            Set the presence status of this client.
-          x-example: "online"
+            Controls whether the client is automatically marked as online by
+            polling this API. If this parameter is omitted then the client is
+            automatically marked as online when it uses this API. Otherwise if
+            the parameter is set to "offline" then the client is not marked as
+            being online when it uses this API.
+          x-example: "offline"
         - in: query
           name: timeout
           type: integer