freeclimb 4.6.0 → 4.6.1

data/openapi.json

@@ -83,16 +83,8 @@
     "schemas": {
       "AccountStatus": {
         "type": "string",
-        "enum": [
-          "closed",
-          "suspended",
-          "active"
-        ],
-        "x-enum-varnames": [
-          "CLOSED",
-          "SUSPENDED",
-          "ACTIVE"
-        ],
+        "enum": ["closed", "suspended", "active"],
+        "x-enum-varnames": ["CLOSED", "SUSPENDED", "ACTIVE"],
         "x-enum": true,
         "description": "The status of this account. It is one of: active, suspended, or closed.",
         "nullable": true
@@ -100,44 +92,24 @@
       "AccountType": {
         "type": "string",
         "description": "The type of this account. It is one of: trial or full.",
-        "enum": [
-          "trial",
-          "full"
-        ],
+        "enum": ["trial", "full"],
         "x-enum": true,
-        "x-enum-varnames": [
-          "TRIAL",
-          "FULL"
-        ],
+        "x-enum-varnames": ["TRIAL", "FULL"],
         "nullable": true
       },
       "AnsweredBy": {
         "type": "string",
         "nullable": true,
-        "enum": [
-          "human",
-          "machine"
-        ],
-        "x-enum-varnames": [
-          "HUMAN",
-          "MACHINE"
-        ],
+        "enum": ["human", "machine"],
+        "x-enum-varnames": ["HUMAN", "MACHINE"],
         "x-enum": true,
         "description": "If this Call was initiated with answering machine detection, either `human` or `machine`. Empty otherwise."
       },
       "CallDirection": {
         "type": "string",
         "nullable": true,
-        "enum": [
-          "inbound",
-          "outboundAPI",
-          "outboundDial"
-        ],
-        "x-enum-varnames": [
-          "INBOUND",
-          "OUTBOUND_API",
-          "OUTBOUND_DIAL"
-        ],
+        "enum": ["inbound", "outboundAPI", "outboundDial"],
+        "x-enum-varnames": ["INBOUND", "OUTBOUND_API", "OUTBOUND_DIAL"],
         "x-enum": true,
         "description": "Direction of the Call. `inbound` for Calls into FreeClimb, `outboundAPI` for Calls initiated via the REST API,  `outboundDial` for Calls initiated by the `OutDial` PerCL command."
       },
@@ -170,18 +142,8 @@
       "ConferenceStatus": {
         "type": "string",
         "nullable": true,
-        "enum": [
-          "empty",
-          "populated",
-          "inProgress",
-          "terminated"
-        ],
-        "x-enum-varnames": [
-          "EMPTY",
-          "POPULATED",
-          "IN_PROGRESS",
-          "TERMINATED"
-        ],
+        "enum": ["empty", "populated", "inProgress", "terminated"],
+        "x-enum-varnames": ["EMPTY", "POPULATED", "IN_PROGRESS", "TERMINATED"],
         "x-enum": true,
         "description": "The status of the Conference. One of: creating, empty, populated, inProgress, or terminated."
       },
@@ -245,28 +207,16 @@
       },
       "GrammarType": {
         "type": "string",
-        "enum": [
-          "URL",
-          "BUILTIN"
-        ],
+        "enum": ["URL", "BUILTIN"],
         "nullable": true,
-        "x-enum-varnames": [
-          "URL",
-          "BUILT_IN"
-        ],
+        "x-enum-varnames": ["URL", "BUILT_IN"],
         "x-enum": true,
         "description": "The grammar file type to use for speech recognition. A value of 'URL' indicates the grammarFile attribute specifies a URL that points to the grammar file. A value of `BUILTIN` indicates the grammarFile attribute specifies the name of one of the platform built-in grammar files."
       },
       "IfMachine": {
         "type": "string",
-        "enum": [
-          "redirect",
-          "hangup"
-        ],
-        "x-enum-varnames": [
-          "REDIRECT",
-          "HANGUP"
-        ],
+        "enum": ["redirect", "hangup"],
+        "x-enum-varnames": ["REDIRECT", "HANGUP"],
         "x-enum": true,
         "description": "Specifies how FreeClimb should handle this OutDial if an answering machine answers the Call. Valid values: `redirect` invokes the ifMachineUrl for instructions. `hangup` hangs up the Call. The ifMachineUrl will not be invoked."
       },
@@ -332,42 +282,22 @@
       },
       "LogLevel": {
         "type": "string",
-        "enum": [
-          "info",
-          "warning",
-          "error"
-        ],
+        "enum": ["info", "warning", "error"],
         "nullable": true,
-        "x-enum-varnames": [
-          "INFO",
-          "WARNING",
-          "ERROR"
-        ],
+        "x-enum-varnames": ["INFO", "WARNING", "ERROR"],
         "x-enum": true,
         "description": "Level of the log. Possible values are info, warning, and error."
       },
       "MachineType": {
         "type": "string",
-        "enum": [
-          "answeringMachine",
-          "faxMachine"
-        ],
-        "x-enum-varnames": [
-          "ANSWERING_MACHINE",
-          "FAX_MACHINE"
-        ],
+        "enum": ["answeringMachine", "faxMachine"],
+        "x-enum-varnames": ["ANSWERING_MACHINE", "FAX_MACHINE"],
         "x-enum": true
       },
       "MessageDirection": {
         "type": "string",
-        "enum": [
-          "inbound",
-          "outbound"
-        ],
-        "x-enum-varnames": [
-          "INBOUND",
-          "OUTBOUND"
-        ],
+        "enum": ["inbound", "outbound"],
+        "x-enum-varnames": ["INBOUND", "OUTBOUND"],
         "x-enum": true
       },
       "MessageStatus": {
@@ -405,18 +335,8 @@
       "PlayBeep": {
         "type": "string",
         "nullable": true,
-        "enum": [
-          "always",
-          "never",
-          "entryOnly",
-          "exitOnly"
-        ],
-        "x-enum-varnames": [
-          "ALWAYS",
-          "NEVER",
-          "ENTRY_ONLY",
-          "EXIT_ONLY"
-        ],
+        "enum": ["always", "never", "entryOnly", "exitOnly"],
+        "x-enum-varnames": ["ALWAYS", "NEVER", "ENTRY_ONLY", "EXIT_ONLY"],
         "x-enum": true,
         "description": "Indicates whether to play a beep when a Participant enters or leaves the Conference. either `always`, `never`, `entryOnly`, or `exitOnly`. Leaving this unset will make conference default to `always` ",
         "default": "always",
@@ -424,34 +344,14 @@
       },
       "QueueResultStatus": {
         "type": "string",
-        "enum": [
-          "queueFull",
-          "dequeued",
-          "hangup",
-          "systemError"
-        ],
-        "x-enum-varnames": [
-          "QUEUE_FULL",
-          "DEQUEUED",
-          "HANGUP",
-          "SYSTEM_ERROR"
-        ],
+        "enum": ["queueFull", "dequeued", "hangup", "systemError"],
+        "x-enum-varnames": ["QUEUE_FULL", "DEQUEUED", "HANGUP", "SYSTEM_ERROR"],
         "x-enum": true
       },
       "RecordUtteranceTermReason": {
         "type": "string",
-        "enum": [
-          "finishKey",
-          "timeout",
-          "hangup",
-          "maxLength"
-        ],
-        "x-enum-varnames": [
-          "FINISH_KEY",
-          "TIMEOUT",
-          "HANGUP",
-          "MAX_LENGTH"
-        ],
+        "enum": ["finishKey", "timeout", "hangup", "maxLength"],
+        "x-enum-varnames": ["FINISH_KEY", "TIMEOUT", "HANGUP", "MAX_LENGTH"],
         "x-enum": true
       },
       "RequestType": {
@@ -510,27 +410,15 @@
       },
       "UpdateCallRequestStatus": {
         "type": "string",
-        "enum": [
-          "canceled",
-          "completed"
-        ],
-        "x-enum-varnames": [
-          "CANCELED",
-          "COMPLETED"
-        ],
+        "enum": ["canceled", "completed"],
+        "x-enum-varnames": ["CANCELED", "COMPLETED"],
         "x-enum": true,
         "description": "Either `canceled` or `completed`.  Specifying `canceled` attempts to hang up calls that are queued without affecting calls already in progress. Specifying `completed` attempts to hang up a call already in progress."
       },
       "UpdateConferenceRequestStatus": {
         "type": "string",
-        "enum": [
-          "empty",
-          "terminated"
-        ],
-        "x-enum-varnames": [
-          "EMPTY",
-          "TERMINATED"
-        ],
+        "enum": ["empty", "terminated"],
+        "x-enum-varnames": ["EMPTY", "TERMINATED"],
         "x-enum": true,
         "description": "New status of the conference. Valid values: `empty` or `terminated`. For more information, see **Status Parameter** below.**"
       },
@@ -585,6 +473,7 @@
         },
         "properties": {
           "command": {
+            "x-is-no-property": true,
             "type": "string",
             "description": "Name of PerCL Command (this is automatically derived from mapping configuration and should not be manually supplied in any arguments)"
           }
@@ -599,9 +488,7 @@
           },
           {
             "type": "object",
-            "required": [
-              "conferenceId"
-            ],
+            "required": ["conferenceId"],
             "properties": {
               "allowCallControl": {
                 "description": "If `true`, Call control will be enabled for this Participant's Call leg.",
@@ -648,14 +535,11 @@
         "x-percl-command": true,
         "allOf": [
           {
-            "$ref": "#/components/schemas/PerclCommand",
-            "x-is-uri": true
+            "$ref": "#/components/schemas/PerclCommand"
           },
           {
             "type": "object",
-            "required": [
-              "actionUrl"
-            ],
+            "required": ["actionUrl"],
             "properties": {
               "actionUrl": {
                 "description": " This URL is invoked once the Conference is successfully created. Actions on the Conference, such as adding Participants, can be performed via the PerCL script returned in the response. ",
@@ -708,11 +592,7 @@
           },
           {
             "type": "object",
-            "required": [
-              "queueId",
-              "waitUrl",
-              "actionUrl"
-            ],
+            "required": ["queueId", "waitUrl", "actionUrl"],
             "properties": {
               "actionUrl": {
                 "description": "A request is made to this URL when the Call leaves the Queue, which can occur if enqueue of the Call fails or when the call is dequeued via the `Dequeue` command, the REST API (POST to Queue Member resource), or the caller hangs up.",
@@ -746,9 +626,7 @@
           },
           {
             "type": "object",
-            "required": [
-              "actionUrl"
-            ],
+            "required": ["actionUrl"],
             "properties": {
               "actionUrl": {
                 "description": "When the Caller has finished entering digits, FreeClimb will make an HTTP POST request to this URL. A PerCL response is expected to continue handling the Call. Make sure to keep “http://“ in the URL.",
@@ -804,16 +682,14 @@
           },
           {
             "type": "object",
-            "required": [
-              "actionUrl",
-              "grammarFile"
-            ],
+            "required": ["actionUrl", "grammarFile"],
             "properties": {
               "actionUrl": {
                 "description": "When the caller has finished speaking or the command has timed out, FreeClimb will make a POST request to this URL. A PerCL response is expected to continue handling the call.",
                 "type": "string",
                 "format": "uri",
-                "x-is-uri": true
+                "x-is-uri": true,
+                "x-is-url": true
               },
               "grammarType": {
                 "$ref": "#/components/schemas/GrammarType"
@@ -960,10 +836,7 @@
           },
           {
             "type": "object",
-            "required": [
-              "waitUrl",
-              "actionUrl"
-            ],
+            "required": ["waitUrl", "actionUrl"],
             "properties": {
               "waitUrl": {
                 "description": "Specifies a URL pointing to a PerCL script containing actions to be executed while the caller is Parked. Once the script returned by the waitUrl runs out of commands to execute, FreeClimb will re-request the waitUrl and start over, essentially looping the script requests indefinitely.",
@@ -992,9 +865,7 @@
           },
           {
             "type": "object",
-            "required": [
-              "length"
-            ],
+            "required": ["length"],
             "properties": {
               "length": {
                 "description": "Length in milliseconds. FreeClimb will wait silently before continuing on.",
@@ -1012,9 +883,7 @@
             "$ref": "#/components/schemas/PerclCommand"
           },
           {
-            "required": [
-              "file"
-            ],
+            "required": ["file"],
             "type": "object",
             "properties": {
               "file": {
@@ -1041,9 +910,7 @@
             "$ref": "#/components/schemas/PerclCommand"
           },
           {
-            "required": [
-              "file"
-            ],
+            "required": ["file"],
             "type": "object",
             "properties": {
               "file": {
@@ -1063,9 +930,7 @@
             "x-is-uri": true
           },
           {
-            "required": [
-              "actionUrl"
-            ],
+            "required": ["actionUrl"],
             "type": "object",
             "properties": {
               "actionUrl": {
@@ -1110,9 +975,7 @@
             "x-is-uri": true
           },
           {
-            "required": [
-              "actionUrl"
-            ],
+            "required": ["actionUrl"],
             "type": "object",
             "properties": {
               "actionUrl": {
@@ -1145,6 +1008,7 @@
       "RemoveFromConference": {
         "description": "The `RemoveFromConference` command removes a Participant from a Conference but does not hang up. Instead, the Call is simply unbridged and what happens next with the Call is determined by the PerCL returned in response to the `leaveConferenceUrl` attribute.",
         "x-percl-command": true,
+        "x-no-properties": true,
         "allOf": [
           {
             "$ref": "#/components/schemas/PerclCommand"
@@ -1164,9 +1028,7 @@
             "$ref": "#/components/schemas/PerclCommand"
           },
           {
-            "required": [
-              "text"
-            ],
+            "required": ["text"],
             "type": "object",
             "properties": {
               "text": {
@@ -1198,9 +1060,7 @@
             "$ref": "#/components/schemas/PerclCommand"
           },
           {
-            "required": [
-              "digits"
-            ],
+            "required": ["digits"],
             "type": "object",
             "properties": {
               "digits": {
@@ -1265,11 +1125,7 @@
             "$ref": "#/components/schemas/PerclCommand"
           },
           {
-            "required": [
-              "to",
-              "from",
-              "text"
-            ],
+            "required": ["to", "from", "text"],
             "type": "object",
             "properties": {
               "to": {
@@ -1277,6 +1133,7 @@
                 "type": "string"
               },
               "from": {
+                "x-is-private-property": true,
                 "description": "E.164 representation of the phone number to use as the sender. This must be an incoming phone number you have purchased from FreeClimb.",
                 "type": "string"
               },
@@ -1308,6 +1165,7 @@
       "TerminateConference": {
         "description": "The `TerminateConference` command terminates an existing Conference. Any active participants are hung up on by FreeClimb. If this is not the desired behavior, use the `RemoveFromConference` command to unbridge Calls that should not be hung up. Note: The Call requesting TerminateConference must be on the same Conference for this command to execute.",
         "x-percl-command": true,
+        "x-no-properties": true,
         "allOf": [
           {
             "$ref": "#/components/schemas/PerclCommand"
@@ -1396,13 +1254,7 @@
       "Capabilities": {
         "description": "Details for which features this number may be used.",
         "type": "object",
-        "required": [
-          "voice",
-          "sms",
-          "tollFree",
-          "tenDLC",
-          "shortCode"
-        ],
+        "required": ["voice", "sms", "tollFree", "tenDLC", "shortCode"],
         "x-is-object": true,
         "properties": {
           "voice": {
@@ -1435,9 +1287,7 @@
       "TFN": {
         "description": "TollFree Campaign details for this number",
         "type": "object",
-        "required": [
-          "campaignId"
-        ],
+        "required": ["campaignId"],
         "x-is-object": true,
         "properties": {
           "campaignId": {
@@ -1794,9 +1644,7 @@
       },
       "BuyIncomingNumberRequest": {
         "type": "object",
-        "required": [
-          "phoneNumber"
-        ],
+        "required": ["phoneNumber"],
         "properties": {
           "phoneNumber": {
             "type": "string",
@@ -1836,6 +1684,7 @@
                 "nullable": true
               },
               "from": {
+                "x-is-private-property": true,
                 "type": "string",
                 "description": "Phone number that initiated this Call.",
                 "nullable": true
@@ -1895,9 +1744,7 @@
       },
       "UpdateCallRequest": {
         "type": "object",
-        "required": [
-          "status"
-        ],
+        "required": ["status"],
         "properties": {
           "status": {
             "$ref": "#/components/schemas/UpdateCallRequestStatus"
@@ -1906,12 +1753,10 @@
       },
       "MakeCallRequest": {
         "type": "object",
-        "required": [
-          "from",
-          "to"
-        ],
+        "required": ["from", "to"],
         "properties": {
           "from": {
+            "x-is-private-property": true,
             "type": "string",
             "description": "Phone number to use as the caller ID. This can be: (a) The To or From number provided in FreeClimb's initial request to your app or (b) Any incoming phone number you have purchased from FreeClimb."
           },
@@ -2177,13 +2022,10 @@
           },
           {
             "type": "object",
-            "required": [
-              "from",
-              "to",
-              "text"
-            ],
+            "required": ["from", "to", "text"],
             "properties": {
               "from": {
+                "x-is-private-property": true,
                 "type": "string",
                 "description": "Phone number to use as the sender. This must be an incoming phone number that you have purchased from FreeClimb."
               },
@@ -2202,6 +2044,7 @@
               "mediaUrls": {
                 "type": "array",
                 "description": "an array of HTTP URLs which are to be used as attachments to the message. This will force the message into being an MMS message and must be done using a from number which is MMS capabile.",
+                "x-is-list": true,
                 "items": {
                   "type": "string",
                   "format": "uri"
@@ -2253,6 +2096,7 @@
                 "$ref": "#/components/schemas/MessageStatus"
               },
               "from": {
+                "x-is-private-property": true,
                 "type": "string",
                 "description": "Phone number in E.164 format that sent the message.",
                 "nullable": true
@@ -2295,6 +2139,7 @@
               "mediaUrls": {
                 "type": "array",
                 "description": "an array of HTTP URLs which were attached this this message",
+                "x-is-list": true,
                 "items": {
                   "type": "string",
                   "format": "uri"
@@ -2552,9 +2397,7 @@
       },
       "FilterLogsRequest": {
         "type": "object",
-        "required": [
-          "pql"
-        ],
+        "required": ["pql"],
         "properties": {
           "pql": {
             "type": "string",
@@ -2617,14 +2460,9 @@
             "type": "string",
             "x-has-writer": true,
             "description": "Current campaign status. Possible values: ACTIVE, EXPIRED. A newly created campaign defaults to ACTIVE status. ",
-            "enum": [
-              "ACTIVE",
-              "EXPIRED"
-            ],
-            "x-enum-varnames": [
-              "ACTIVE",
-              "EXPIRED"
-            ]
+            "x-enum-type": "SMSTenDLCCampaignStatusEnum",
+            "enum": ["ACTIVE", "EXPIRED"],
+            "x-enum-varnames": ["ACTIVE", "EXPIRED"]
           },
           "createDate": {
             "type": "string",
@@ -2849,12 +2687,7 @@
         ]
       },
       "SMSTenDLCPartnerCampaign": {
-        "required": [
-          "brandId",
-          "campaignId",
-          "description",
-          "usecase"
-        ],
+        "required": ["brandId", "campaignId", "description", "usecase"],
         "type": "object",
         "properties": {
           "accountId": {
@@ -2870,14 +2703,9 @@
             "type": "string",
             "x-has-writer": true,
             "description": "Current campaign status. Possible values: ACTIVE, EXPIRED. A newly created campaign defaults to ACTIVE status. ",
-            "enum": [
-              "ACTIVE",
-              "EXPIRED"
-            ],
-            "x-enum-varnames": [
-              "ACTIVE",
-              "EXPIRED"
-            ]
+            "x-enum-type": "SMSTenDLCPartnerCampaignStatusEnum",
+            "enum": ["ACTIVE", "EXPIRED"],
+            "x-enum-varnames": ["ACTIVE", "EXPIRED"]
           },
           "createDate": {
             "type": "string",
@@ -3056,10 +2884,7 @@
         }
       },
       "SMSTenDLCPartnerCampaignBrand": {
-        "required": [
-          "email",
-          "phone"
-        ],
+        "required": ["email", "phone"],
         "type": "object",
         "x-is-object": true,
         "properties": {
@@ -3163,6 +2988,7 @@
           "vertical"
         ],
         "type": "object",
+        "x-sms-ten-dlc-brand": true,
         "properties": {
           "accountId": {
             "type": "string",
@@ -3174,6 +3000,7 @@
             "type": "string",
             "x-has-writer": true,
             "description": "Entity type behind the brand. This is the form of business establishment.",
+            "x-enum-type": "SMSTenDLCBrandEntityTypeEnum",
             "enum": [
               "PRIVATE_PROFIT",
               "PUBLIC_PROFIT",
@@ -3287,6 +3114,7 @@
             "x-has-writer": true,
             "description": "(Required for public company) stock exchange.",
             "example": "NASDAQ",
+            "x-enum-type": "SMSTenDLCBrandStockExchangeEnum",
             "enum": [
               "NONE",
               "NASDAQ",
@@ -3361,6 +3189,7 @@
             "type": "string",
             "x-has-writer": true,
             "description": "Brand relationship to the CSP",
+            "x-enum-type": "SMSTenDLCBrandBrandRelationshipEnum",
             "enum": [
               "BASIC_ACCOUNT",
               "SMALL_ACCOUNT",
@@ -3389,18 +3218,9 @@
           "altBusinessIdType": {
             "type": "string",
             "x-has-writer": true,
-            "enum": [
-              "NONE",
-              "DUNS",
-              "GIIN",
-              "LEI"
-            ],
-            "x-enum-varnames": [
-              "NONE",
-              "DUNS",
-              "GIIN",
-              "LEI"
-            ],
+            "x-enum-type": "SMSTenDLCBrandAltBusinessIdTypeEnum",
+            "enum": ["NONE", "DUNS", "GIIN", "LEI"],
+            "x-enum-varnames": ["NONE", "DUNS", "GIIN", "LEI"],
             "description": "The type of the Alternative business identifier"
           },
           "universalEin": {
@@ -3431,6 +3251,7 @@
             "type": "string",
             "x-has-writer": true,
             "description": "TCR assessment of the brand identification status.",
+            "x-enum-type": "SMSTenDLCBrandIdentityStatusEnum",
             "enum": [
               "SELF_DECLARED",
               "UNVERIFIED",
@@ -3515,6 +3336,7 @@
           "dateUpdated",
           "revision"
         ],
+        "x-sms-toll-free-campaign": true,
         "properties": {
           "accountId": {
             "type": "string",
@@ -3532,6 +3354,7 @@
             "type": "string",
             "x-has-writer": true,
             "description": "Current toll-free campaign registration status.Possible values: UNREGISTERED,INITIATED,PENDING,DECLINED,REGISTERED. A newly created campaign defaults to INITIATED status. ",
+            "x-enum-type": "SMSTollFreeCampaignRegistrationStatusEnum",
             "enum": [
               "UNREGISTERED",
               "INITIATED",
@@ -3563,58 +3386,66 @@
         "x-stoplight": {
           "id": "u509r3zqc38ze"
         },
-        "x-percl-command": true,
-        "type": "object",
         "description": "The `TranscribeUtterance` command transcribes the caller’s voice and returns transcription of the audio and optionally returns the recording of the audio transcribed.\n\n`TranscribeUtterance` is blocking and is a terminal command. As such, the actionUrl property is required, and control of the Call picks up using the `PerCL` returned in response of the `actionUrl`. Recording and Transcription information is returned in the actionUrl request. If the reason this command ended was due to the call hanging up, any PerCL returned will not execute.",
-        "properties": {
-          "actionUrl": {
-            "type": "string"
-          },
-          "playBeep": {
-            "type": "boolean",
-            "default": false
+        "x-percl-command": true,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/PerclCommand"
           },
-          "record": {
+          {
+            "required": ["actionUrl"],
             "type": "object",
+            "description": "The `TranscribeUtterance` command transcribes the caller’s voice and returns transcription of the audio and optionally returns the recording of the audio transcribed.\n\n`TranscribeUtterance` is blocking and is a terminal command. As such, the actionUrl property is required, and control of the Call picks up using the `PerCL` returned in response of the `actionUrl`. Recording and Transcription information is returned in the actionUrl request. If the reason this command ended was due to the call hanging up, any PerCL returned will not execute.",
             "properties": {
-              "saveRecording": {
+              "actionUrl": {
+                "type": "string"
+              },
+              "playBeep": {
                 "type": "boolean",
                 "default": false
               },
-              "maxLengthSec": {
-                "type": "integer",
-                "minimum": 1,
-                "maximum": 60,
-                "default": 60
+              "record": {
+                "type": "object",
+                "x-is-object": true,
+                "properties": {
+                  "saveRecording": {
+                    "type": "boolean",
+                    "default": false
+                  },
+                  "maxLengthSec": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 60,
+                    "default": 60
+                  },
+                  "rcrdTerminationSilenceTimeMs": {
+                    "type": "integer",
+                    "exclusiveMinimum": true,
+                    "minimum": 0,
+                    "maximum": 3000
+                  }
+                }
               },
-              "rcrdTerminationSilenceTimeMs": {
-                "type": "integer",
-                "exclusiveMinimum": true,
-                "minimum": 0,
-                "maximum": 3000
+              "privacyForLogging": {
+                "type": "boolean",
+                "default": false
+              },
+              "privacyForRecording": {
+                "type": "boolean",
+                "default": false
+              },
+              "prompts": {
+                "type": "array",
+                "x-is-list": true,
+                "items": {}
               }
             }
-          },
-          "privacyForLogging": {
-            "type": "boolean",
-            "default": false
-          },
-          "privacyForRecording": {
-            "type": "boolean",
-            "default": false
-          },
-          "prompts": {
-            "type": "array",
-            "items": {}
           }
-        },
-        "required": [
-          "actionUrl"
         ],
         "x-examples": {
           "Example 1": {
             "TranscribeUtterance": {
-              "actionUrl": "http://foo.vail/handleTranscription",
+              "actionUrl": "http://yoursite.com/handleTranscription",
               "record": {
                 "maxLengthSec": 60,
                 "saveRecording": true,
@@ -3634,11 +3465,8 @@
       },
       "CreateWebRTCToken": {
         "type": "object",
-        "required": [
-          "to",
-          "from",
-          "uses"
-        ],
+        "required": ["to", "from", "uses"],
+        "x-web-rtc": true,
         "additionalProperties": false,
         "properties": {
           "to": {
@@ -3646,6 +3474,7 @@
             "description": "E.164 formatted phone number to which calls using this token will be made."
           },
           "from": {
+            "x-is-private-property": true,
             "type": "string",
             "description": "E.164 formatted phone number owned by the reqeusting account from which calls using this token will be made."
           },
@@ -4534,6 +4363,7 @@
         "summary": "Make a JWT for WebRTC calling",
         "description": "Make a JWT for WebRTC calling",
         "operationId": "make-a-webrtc-jwt",
+        "x-web-rtc": true,
         "parameters": [
           {
             "$ref": "#/components/parameters/AccountId"
@@ -4923,15 +4753,6 @@
               "type": "string"
             }
           },
-          {
-            "name": "conferenceId",
-            "in": "query",
-            "description": "Show only Recordings made during the conference with this ID.",
-            "required": false,
-            "schema": {
-              "type": "string"
-            }
-          },
           {
             "name": "dateCreated",
             "in": "query",
@@ -4943,6 +4764,15 @@
           },
           {
             "$ref": "#/components/parameters/AccountId"
+          },
+          {
+            "name": "conferenceId",
+            "in": "path",
+            "description": "Show only Recordings made during the conference with this ID.",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
           }
         ],
         "responses": {
@@ -6110,11 +5940,5 @@
   "x-explorer-enabled": true,
   "x-proxy-enabled": true,
   "x-samples-enabled": false,
-  "x-samples-languages": [
-    "curl",
-    "node",
-    "ruby",
-    "javascript",
-    "python"
-  ]
-}
+  "x-samples-languages": ["curl", "node", "ruby", "javascript", "python"]
+}