From e50869672eaeb05ed5525ddb69316c79fa2dfd84 Mon Sep 17 00:00:00 2001
From: Cody Reichert <cody@reichertbrothers.com>
Date: Thu, 3 Feb 2022 12:56:53 -0600
Subject: [PATCH] Add docs for salesOffice query parameter

---
 api/simplyrets-openapi.yaml | 31 +++++++++++++++++++++++--------
 1 file changed, 23 insertions(+), 8 deletions(-)

diff --git a/api/simplyrets-openapi.yaml b/api/simplyrets-openapi.yaml
index 50f0997..fcd9b51 100644
--- a/api/simplyrets-openapi.yaml
+++ b/api/simplyrets-openapi.yaml
@@ -474,8 +474,9 @@ paths:
       - "$ref": "#/components/parameters/subtype"
       - "$ref": "#/components/parameters/subTypeText"
       - "$ref": "#/components/parameters/agent"
-      - "$ref": "#/components/parameters/salesAgent"
       - "$ref": "#/components/parameters/brokers"
+      - "$ref": "#/components/parameters/salesAgent"
+      - "$ref": "#/components/parameters/salesOffice"
       - "$ref": "#/components/parameters/specialListingConditions"
       - "$ref": "#/components/parameters/ownership"
       - "$ref": "#/components/parameters/minprice"
@@ -1264,6 +1265,21 @@ components:
         type: array
         items:
           type: string
+    brokers:
+      required: false
+      in: query
+      name: brokers
+      description: |
+        Filter the listings returned by brokerage with a Broker
+        ID. For some MLS areas, this is the ListOfficeId (Listing
+        Office ID).  You can specific multiple broker
+        parameters. Note, this query parameter is only available
+        if a Broker ID is provided by your RETS vendor or MLS.
+      explode: true
+      schema:
+        type: array
+        items:
+          type: string
     salesAgent:
       required: false
       in: query
@@ -1281,16 +1297,15 @@ components:
         type: array
         items:
           type: string
-    brokers:
+    salesOffice:
       required: false
       in: query
-      name: brokers
+      name: salesOffice
       description: |
-        Filter the listings returned by brokerage with a Broker
-        ID. For some MLS areas, this is the ListOfficeId (Listing
-        Office ID).  You can specific multiple broker
-        parameters. Note, this query parameter is only available
-        if a Broker ID is provided by your RETS vendor or MLS.
+        Filter the listings returned by the `sales.office.brokerid`
+        field. This parameter can be specified multiple times.
+
+        Note, Office MLS IDs are provided by your MLS or data vendor.
       explode: true
       schema:
         type: array