#1326 Update all plugins: Twilio from 5.16.6 to 5.19.6

plugins/Twilio/Deserialize.php

@@ -55,8 +55,8 @@ abstract class Domain {
      * @return \Twilio\Http\Response the response for the request
      */
     public function request($method, $uri, $params = array(), $data = array(),
-                            $headers = array(), $user = null, $password = null,
-                            $timeout = null) {
+                            $headers = array(), $user = null, $password=null,
+                            $timeout=null) {
         $url = $this->absoluteUrl($uri);
         return $this->client->request(
             $method,

plugins/Twilio/Exceptions/ConfigurationException.php

@@ -1,188 +1,186 @@
-<?php
-
-
-namespace Twilio\Http;
-
-
-use Twilio\Exceptions\EnvironmentException;
-
-class CurlClient implements Client {
-    const DEFAULT_TIMEOUT = 60;
-    protected $curlOptions = array();
-    protected $debugHttp = false;
-
-    public $lastRequest = null;
-    public $lastResponse = null;
-
-    public function __construct(array $options = array()) {
-        $this->curlOptions = $options;
-        $this->debugHttp = getenv('DEBUG_HTTP_TRAFFIC') === 'true';
-    }
-
-    public function request($method, $url, $params = array(), $data = array(),
-                            $headers = array(), $user = null, $password = null,
-                            $timeout = null) {
-        $options = $this->options($method, $url, $params, $data, $headers,
-                                  $user, $password, $timeout);
-
-        $this->lastRequest = $options;
-        $this->lastResponse = null;
-
-        try {
-            if (!$curl = curl_init()) {
-                throw new EnvironmentException('Unable to initialize cURL');
-            }
-
-            if (!curl_setopt_array($curl, $options)) {
-                throw new EnvironmentException(curl_error($curl));
-            }
-
-            if (!$response = curl_exec($curl)) {
-                throw new EnvironmentException(curl_error($curl));
-            }
-
-            $parts = explode("\r\n\r\n", $response, 3);
-            list($head, $body) = ($parts[0] == 'HTTP/1.1 100 Continue')
-                               ? array($parts[1], $parts[2])
-                               : array($parts[0], $parts[1]);
-
-            if ($this->debugHttp) {
-                $u = parse_url($url);
-                $hdrLine = $method . ' ' . $u['path'];
-                if (isset($u['query']) && strlen($u['query']) > 0 ) {
-                    $hdrLine = $hdrLine . '?' . $u['query'];
-                }
-                error_log($hdrLine);
-                foreach ($headers as $key => $value) {
-                    error_log("$key: $value");
-                }
-                if ($method === 'POST') {
-                    error_log("\n" . $options[CURLOPT_POSTFIELDS] . "\n");
-                }
-            }
-            $statusCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
-
-            $responseHeaders = array();
-            $headerLines = explode("\r\n", $head);
-            array_shift($headerLines);
-            foreach ($headerLines as $line) {
-                list($key, $value) = explode(':', $line, 2);
-                $responseHeaders[$key] = $value;
-            }
-
-            curl_close($curl);
-
-            if (isset($buffer) && is_resource($buffer)) {
-                fclose($buffer);
-            }
-
-            if ($this->debugHttp) {
-                error_log("HTTP/1.1 $statusCode");
-                foreach ($responseHeaders as $key => $value) {
-                    error_log("$key: $value");
-                }
-                error_log("\n$body");
-            }
-
-            $this->lastResponse = new Response($statusCode, $body, $responseHeaders);
-
-            return $this->lastResponse;
-        } catch (\ErrorException $e) {
-            if (isset($curl) && is_resource($curl)) {
-                curl_close($curl);
-            }
-
-            if (isset($buffer) && is_resource($buffer)) {
-                fclose($buffer);
-            }
-
-            throw $e;
-        }
-    }
-
-    public function options($method, $url, $params = array(), $data = array(),
-                            $headers = array(), $user = null, $password = null,
-                            $timeout = null) {
-
-        $timeout = is_null($timeout)
-            ? self::DEFAULT_TIMEOUT
-            : $timeout;
-        $options = $this->curlOptions + array(
-            CURLOPT_URL => $url,
-            CURLOPT_HEADER => true,
-            CURLOPT_RETURNTRANSFER => true,
-            CURLOPT_INFILESIZE => Null,
-            CURLOPT_HTTPHEADER => array(),
-            CURLOPT_TIMEOUT => $timeout,
-            CURLOPT_SSL_VERIFYHOST => 0,
-            CURLOPT_SSL_VERIFYPEER => 0
-        );
-
-        foreach ($headers as $key => $value) {
-            $options[CURLOPT_HTTPHEADER][] = "$key: $value";
-        }
-
-        if ($user && $password) {
-            $options[CURLOPT_HTTPHEADER][] = 'Authorization: Basic ' . base64_encode("$user:$password");
-        }
-
-        $body = $this->buildQuery($params);
-        if ($body) {
-            $options[CURLOPT_URL] .= '?' . $body;
-        }
-
-        switch (strtolower(trim($method))) {
-            case 'get':
-                $options[CURLOPT_HTTPGET] = true;
-                break;
-            case 'post':
-                $options[CURLOPT_POST] = true;
-                $options[CURLOPT_POSTFIELDS] = $this->buildQuery($data);
-
-                break;
-            case 'put':
-                $options[CURLOPT_PUT] = true;
-                if ($data) {
-                    if ($buffer = fopen('php://memory', 'w+')) {
-                        $dataString = $this->buildQuery($data);
-                        fwrite($buffer, $dataString);
-                        fseek($buffer, 0);
-                        $options[CURLOPT_INFILE] = $buffer;
-                        $options[CURLOPT_INFILESIZE] = strlen($dataString);
-                    } else {
-                        throw new EnvironmentException('Unable to open a temporary file');
-                    }
-                }
-                break;
-            case 'head':
-                $options[CURLOPT_NOBODY] = true;
-                break;
-            default:
-                $options[CURLOPT_CUSTOMREQUEST] = strtoupper($method);
-        }
-
-        return $options;
-    }
-
-    public function buildQuery($params) {
-        $parts = array();
-
-        if (is_string($params)) {
-            return $params;
-        }
-
-        $params = $params ?: array();
-
-        foreach ($params as $key => $value) {
-            if (is_array($value)) {
-                foreach ($value as $item) {
-                    $parts[] = urlencode((string)$key) . '=' . urlencode((string)$item);
-                }
-            } else {
-                $parts[] = urlencode((string)$key) . '=' . urlencode((string)$value);
-            }
-        }
-
-        return implode('&', $parts);
-    }
-}
+<?php
+
+
+namespace Twilio\Http;
+
+
+use Twilio\Exceptions\EnvironmentException;
+
+class CurlClient implements Client {
+    const DEFAULT_TIMEOUT = 60;
+    protected $curlOptions = array();
+    protected $debugHttp = false;
+
+    public $lastRequest = null;
+    public $lastResponse = null;
+
+    public function __construct(array $options = array()) {
+        $this->curlOptions = $options;
+        $this->debugHttp = getenv('DEBUG_HTTP_TRAFFIC') === 'true';
+    }
+
+    public function request($method, $url, $params = array(), $data = array(),
+                            $headers = array(), $user = null, $password = null,
+                            $timeout = null) {
+        $options = $this->options($method, $url, $params, $data, $headers,
+                                  $user, $password, $timeout);
+
+        $this->lastRequest = $options;
+        $this->lastResponse = null;
+
+        try {
+            if (!$curl = curl_init()) {
+                throw new EnvironmentException('Unable to initialize cURL');
+            }
+
+            if (!curl_setopt_array($curl, $options)) {
+                throw new EnvironmentException(curl_error($curl));
+            }
+
+            if (!$response = curl_exec($curl)) {
+                throw new EnvironmentException(curl_error($curl));
+            }
+
+            $parts = explode("\r\n\r\n", $response, 3);
+            list($head, $body) = ($parts[0] == 'HTTP/1.1 100 Continue')
+                               ? array($parts[1], $parts[2])
+                               : array($parts[0], $parts[1]);
+
+            if ($this->debugHttp) {
+                $u = parse_url($url);
+                $hdrLine = $method . ' ' . $u['path'];
+                if (isset($u['query']) && strlen($u['query']) > 0 ) {
+                    $hdrLine = $hdrLine . '?' . $u['query'];
+                }
+                error_log($hdrLine);
+                foreach ($headers as $key => $value) {
+                    error_log("$key: $value");
+                }
+                if ($method === 'POST') {
+                    error_log("\n" . $options[CURLOPT_POSTFIELDS] . "\n");
+                }
+            }
+            $statusCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
+
+            $responseHeaders = array();
+            $headerLines = explode("\r\n", $head);
+            array_shift($headerLines);
+            foreach ($headerLines as $line) {
+                list($key, $value) = explode(':', $line, 2);
+                $responseHeaders[$key] = $value;
+            }
+
+            curl_close($curl);
+
+            if (isset($buffer) && is_resource($buffer)) {
+                fclose($buffer);
+            }
+
+            if ($this->debugHttp) {
+                error_log("HTTP/1.1 $statusCode");
+                foreach ($responseHeaders as $key => $value) {
+                    error_log("$key: $value");
+                }
+                error_log("\n$body");
+            }
+
+            $this->lastResponse = new Response($statusCode, $body, $responseHeaders);
+
+            return $this->lastResponse;
+        } catch (\ErrorException $e) {
+            if (isset($curl) && is_resource($curl)) {
+                curl_close($curl);
+            }
+
+            if (isset($buffer) && is_resource($buffer)) {
+                fclose($buffer);
+            }
+
+            throw $e;
+        }
+    }
+
+    public function options($method, $url, $params = array(), $data = array(),
+                            $headers = array(), $user = null, $password = null,
+                            $timeout = null) {
+
+        $timeout = is_null($timeout)
+            ? self::DEFAULT_TIMEOUT
+            : $timeout;
+        $options = $this->curlOptions + array(
+            CURLOPT_URL => $url,
+            CURLOPT_HEADER => true,
+            CURLOPT_RETURNTRANSFER => true,
+            CURLOPT_INFILESIZE => Null,
+            CURLOPT_HTTPHEADER => array(),
+            CURLOPT_TIMEOUT => $timeout,
+        );
+
+        foreach ($headers as $key => $value) {
+            $options[CURLOPT_HTTPHEADER][] = "$key: $value";
+        }
+
+        if ($user && $password) {
+            $options[CURLOPT_HTTPHEADER][] = 'Authorization: Basic ' . base64_encode("$user:$password");
+        }
+
+        $body = $this->buildQuery($params);
+        if ($body) {
+            $options[CURLOPT_URL] .= '?' . $body;
+        }
+
+        switch (strtolower(trim($method))) {
+            case 'get':
+                $options[CURLOPT_HTTPGET] = true;
+                break;
+            case 'post':
+                $options[CURLOPT_POST] = true;
+                $options[CURLOPT_POSTFIELDS] = $this->buildQuery($data);
+
+                break;
+            case 'put':
+                $options[CURLOPT_PUT] = true;
+                if ($data) {
+                    if ($buffer = fopen('php://memory', 'w+')) {
+                        $dataString = $this->buildQuery($data);
+                        fwrite($buffer, $dataString);
+                        fseek($buffer, 0);
+                        $options[CURLOPT_INFILE] = $buffer;
+                        $options[CURLOPT_INFILESIZE] = strlen($dataString);
+                    } else {
+                        throw new EnvironmentException('Unable to open a temporary file');
+                    }
+                }
+                break;
+            case 'head':
+                $options[CURLOPT_NOBODY] = true;
+                break;
+            default:
+                $options[CURLOPT_CUSTOMREQUEST] = strtoupper($method);
+        }
+
+        return $options;
+    }
+
+    public function buildQuery($params) {
+        $parts = array();
+
+        if (is_string($params)) {
+            return $params;
+        }
+
+        $params = $params ?: array();
+
+        foreach ($params as $key => $value) {
+            if (is_array($value)) {
+                foreach ($value as $item) {
+                    $parts[] = urlencode((string)$key) . '=' . urlencode((string)$item);
+                }
+            } else {
+                $parts[] = urlencode((string)$key) . '=' . urlencode((string)$value);
+            }
+        }
+
+        return implode('&', $parts);
+    }
+}

plugins/Twilio/Http/Response.php

@@ -14,6 +14,8 @@ class AccessToken {
     private $nbf;
     /** @var Grant[] $grants */
     private $grants;
+    /** @var string[] $customClaims */
+    private $customClaims;
 
     public function __construct($accountSid, $signingKeySid, $secret, $ttl = 3600, $identity = null) {
         $this->signingKeySid = $signingKeySid;
@@ -26,6 +28,7 @@ class AccessToken {
         }
 
         $this->grants = array();
+        $this->customClaims = array();
     }
 
     /**
@@ -82,6 +85,15 @@ class AccessToken {
         return $this;
     }
 
+    /**
+     * Allows to set custom claims, which then will be encoded into JWT payload.
+     *
+     * @param string $name
+     * @param string $value
+     */
+    public function addClaim($name, $value) {
+        $this->customClaims[$name] = $value;
+    }
 
     public function toJWT($algorithm = 'HS256') {
         $header = array(
@@ -109,13 +121,13 @@ class AccessToken {
             $grants = json_decode('{}');
         }
 
-        $payload = array(
+        $payload = array_merge($this->customClaims, array(
             'jti' => $this->signingKeySid . '-' . $now,
             'iss' => $this->signingKeySid,
             'sub' => $this->accountSid,
             'exp' => $now + $this->ttl,
             'grants' => $grants
-        );
+        ));
 
         if (!is_null($this->nbf)) {
             $payload['nbf'] = $this->nbf;
@@ -127,4 +139,4 @@ class AccessToken {
     public function __toString() {
         return $this->toJWT();
     }
-}
+}

plugins/Twilio/Jwt/Client/ScopeURI.php

@@ -13,6 +13,8 @@ class ClientToken {
     public $authToken;
     /** @var ScopeURI[] $scopes */
     public $scopes;
+    /** @var string[] $customClaims */
+    private $customClaims;
 
     /**
      * Create a new TwilioCapability with zero permissions. Next steps are to
@@ -29,6 +31,7 @@ class ClientToken {
         $this->authToken = $authToken;
         $this->scopes = array();
         $this->clientName = false;
+        $this->customClaims = array();
     }
 
     /**
@@ -82,6 +85,16 @@ class ClientToken {
         ));
     }
 
+    /**
+     * Allows to set custom claims, which then will be encoded into JWT payload.
+     *
+     * @param string $name
+     * @param string $value
+     */
+    public function addClaim($name, $value) {
+        $this->customClaims[$name] = $value;
+    }
+
     /**
      * Generates a new token based on the credentials and permissions that
      * previously has been granted to this token.
@@ -92,11 +105,11 @@ class ClientToken {
      *         seconds
      */
     public function generateToken($ttl = 3600) {
-        $payload = array(
+        $payload = array_merge($this->customClaims, array(
             'scope' => array(),
             'iss' => $this->accountSid,
             'exp' => time() + $ttl,
-        );
+        ));
         $scopeStrings = array();
 
         foreach ($this->scopes as $scope) {
@@ -112,4 +125,4 @@ class ClientToken {
     protected function allow($service, $privilege, $params) {
         $this->scopes[] = new ScopeURI($service, $privilege, $params);
     }
-}
+}

plugins/Twilio/Jwt/Grants/ChatGrant.php

@@ -6,11 +6,35 @@ namespace Twilio\Jwt\Grants;
 
 class VoiceGrant implements Grant {
 
+    private $incomingAllow;
     private $outgoingApplicationSid;
     private $outgoingApplicationParams;
     private $pushCredentialSid;
     private $endpointId;
 
+    /**
+     * Returns whether incoming is allowed
+     *
+     * @return boolean whether incoming is allowed
+     */
+    public function getIncomingAllow()
+    {
+        return $this->incomingAllow;
+    }
+
+    /**
+     * Set whether incoming is allowed
+     *
+     * @param boolean $incomingAllow whether incoming is allowed
+     *
+     * @return $this updated grant
+     */
+    public function setIncomingAllow($incomingAllow)
+    {
+        $this->incomingAllow = $incomingAllow;
+        return $this;
+    }
+
     /**
      * Returns the outgoing application sid
      *
@@ -122,6 +146,12 @@ class VoiceGrant implements Grant {
     public function getPayload()
     {
         $payload = array();
+        if ($this->incomingAllow == true) {
+            $incoming = array();
+            $incoming['allow'] = true;
+            $payload['incoming'] = $incoming;
+        }
+
         if ($this->outgoingApplicationSid) {
             $outgoing = array();
             $outgoing['application_sid'] = $this->outgoingApplicationSid;
@@ -145,4 +175,4 @@ class VoiceGrant implements Grant {
     }
 
 
-}
+}

plugins/Twilio/Jwt/JWT.php

@@ -64,7 +64,7 @@ abstract class Page implements \Iterator {
         return array_key_exists('meta', $this->payload) && array_key_exists($key, $this->payload['meta']);
     }
 
-    protected function getMeta($key, $default = null) {
+    protected function getMeta($key, $default=null) {
         return $this->hasMeta($key) ? $this->payload['meta'][$key] : $default;
     }
 

plugins/Twilio/Rest/Accounts.php

@@ -35,6 +35,7 @@ class AwsContext extends InstanceContext {
      * Fetch a AwsInstance
      * 
      * @return AwsInstance Fetched AwsInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -53,6 +54,7 @@ class AwsContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return AwsInstance Updated AwsInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);
@@ -73,6 +75,7 @@ class AwsContext extends InstanceContext {
      * Deletes the AwsInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Accounts/V1/Credential/AwsInstance.php

@@ -68,6 +68,7 @@ class AwsInstance extends InstanceResource {
      * Fetch a AwsInstance
      * 
      * @return AwsInstance Fetched AwsInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -78,6 +79,7 @@ class AwsInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return AwsInstance Updated AwsInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);
@@ -87,6 +89,7 @@ class AwsInstance extends InstanceResource {
      * Deletes the AwsInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Accounts/V1/Credential/AwsList.php

@@ -122,6 +122,7 @@ class AwsList extends ListResource {
      * @param string $credentials The credentials
      * @param array|Options $options Optional Arguments
      * @return AwsInstance Newly created AwsInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($credentials, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Accounts/V1/Credential/AwsOptions.php

@@ -35,6 +35,7 @@ class PublicKeyContext extends InstanceContext {
      * Fetch a PublicKeyInstance
      * 
      * @return PublicKeyInstance Fetched PublicKeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -53,6 +54,7 @@ class PublicKeyContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return PublicKeyInstance Updated PublicKeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);
@@ -73,6 +75,7 @@ class PublicKeyContext extends InstanceContext {
      * Deletes the PublicKeyInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Accounts/V1/Credential/PublicKeyInstance.php

@@ -69,6 +69,7 @@ class PublicKeyInstance extends InstanceResource {
      * Fetch a PublicKeyInstance
      * 
      * @return PublicKeyInstance Fetched PublicKeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -79,6 +80,7 @@ class PublicKeyInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return PublicKeyInstance Updated PublicKeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);
@@ -88,6 +90,7 @@ class PublicKeyInstance extends InstanceResource {
      * Deletes the PublicKeyInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Accounts/V1/Credential/PublicKeyList.php

@@ -122,6 +122,7 @@ class PublicKeyList extends ListResource {
      * @param string $publicKey URL encoded representation of the public key
      * @param array|Options $options Optional Arguments
      * @return PublicKeyInstance Newly created PublicKeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($publicKey, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Accounts/V1/Credential/PublicKeyOptions.php

@@ -417,7 +417,7 @@ class Api extends Domain {
     }
 
     /**
-     * @param string $sid Fetch by unique transcription Sid
+     * @param string $sid Fetch by unique transcription SID
      * @return \Twilio\Rest\Api\V2010\Account\TranscriptionContext 
      */
     protected function contextTranscriptions($sid) {

plugins/Twilio/Rest/Api/V2010.php

@@ -50,7 +50,8 @@ class DependentPhoneNumberInstance extends InstanceResource {
      * @param \Twilio\Version $version Version that contains the resource
      * @param mixed[] $payload The response payload
      * @param string $accountSid The account_sid
-     * @param string $addressSid The sid
+     * @param string $addressSid A 34 character string that uniquely identifies
+     *                           this address.
      * @return \Twilio\Rest\Api\V2010\Account\Address\DependentPhoneNumberInstance 
      */
     public function __construct(Version $version, array $payload, $accountSid, $addressSid) {

plugins/Twilio/Rest/Api/V2010/Account/Address/DependentPhoneNumberList.php

@@ -19,7 +19,8 @@ class DependentPhoneNumberList extends ListResource {
      * 
      * @param Version $version Version that contains the resource
      * @param string $accountSid The account_sid
-     * @param string $addressSid The sid
+     * @param string $addressSid A 34 character string that uniquely identifies
+     *                           this address.
      * @return \Twilio\Rest\Api\V2010\Account\Address\DependentPhoneNumberList 
      */
     public function __construct(Version $version, $accountSid, $addressSid) {

plugins/Twilio/Rest/Api/V2010/Account/Address/DependentPhoneNumberPage.php

@@ -44,6 +44,7 @@ class AddressContext extends InstanceContext {
      * Deletes the AddressInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);
@@ -53,6 +54,7 @@ class AddressContext extends InstanceContext {
      * Fetch a AddressInstance
      * 
      * @return AddressInstance Fetched AddressInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -76,6 +78,7 @@ class AddressContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return AddressInstance Updated AddressInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/AddressInstance.php

@@ -40,7 +40,8 @@ class AddressInstance extends InstanceResource {
      * 
      * @param \Twilio\Version $version Version that contains the resource
      * @param mixed[] $payload The response payload
-     * @param string $accountSid The account_sid
+     * @param string $accountSid The unique id of the Account responsible for this
+     *                           address.
      * @param string $sid The sid
      * @return \Twilio\Rest\Api\V2010\Account\AddressInstance 
      */
@@ -91,6 +92,7 @@ class AddressInstance extends InstanceResource {
      * Deletes the AddressInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();
@@ -100,6 +102,7 @@ class AddressInstance extends InstanceResource {
      * Fetch a AddressInstance
      * 
      * @return AddressInstance Fetched AddressInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -110,6 +113,7 @@ class AddressInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return AddressInstance Updated AddressInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);

plugins/Twilio/Rest/Api/V2010/Account/AddressList.php

@@ -20,7 +20,8 @@ class AddressList extends ListResource {
      * Construct the AddressList
      * 
      * @param Version $version Version that contains the resource
-     * @param string $accountSid The account_sid
+     * @param string $accountSid The unique id of the Account responsible for this
+     *                           address.
      * @return \Twilio\Rest\Api\V2010\Account\AddressList 
      */
     public function __construct(Version $version, $accountSid) {
@@ -35,14 +36,20 @@ class AddressList extends ListResource {
     /**
      * Create a new AddressInstance
      * 
-     * @param string $customerName The customer_name
-     * @param string $street The street
-     * @param string $city The city
-     * @param string $region The region
-     * @param string $postalCode The postal_code
-     * @param string $isoCountry The iso_country
+     * @param string $customerName Your name or business name, or that of your
+     *                             customer.
+     * @param string $street The number and street address where you or your
+     *                       customer is located.
+     * @param string $city The city in which you or your customer is located.
+     * @param string $region The state or region in which you or your customer is
+     *                       located.
+     * @param string $postalCode The postal code in which you or your customer is
+     *                           located.
+     * @param string $isoCountry The ISO country code of your or your customer's
+     *                           address.
      * @param array|Options $options Optional Arguments
      * @return AddressInstance Newly created AddressInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($customerName, $street, $city, $region, $postalCode, $isoCountry, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/AddressOptions.php

@@ -14,9 +14,12 @@ use Twilio\Values;
 
 abstract class AddressOptions {
     /**
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A human-readable description of the new address.
      * @param boolean $emergencyEnabled The emergency_enabled
-     * @param boolean $autoCorrectAddress The auto_correct_address
+     * @param boolean $autoCorrectAddress If you don't set a value for this
+     *                                    parameter, or if you set it to true, then
+     *                                    the system will, if necessary,
+     *                                    auto-correct the address you provide.
      * @return CreateAddressOptions Options builder
      */
     public static function create($friendlyName = Values::NONE, $emergencyEnabled = Values::NONE, $autoCorrectAddress = Values::NONE) {
@@ -24,14 +27,21 @@ abstract class AddressOptions {
     }
 
     /**
-     * @param string $friendlyName The friendly_name
-     * @param string $customerName The customer_name
-     * @param string $street The street
-     * @param string $city The city
-     * @param string $region The region
-     * @param string $postalCode The postal_code
+     * @param string $friendlyName A human-readable description of the address.
+     * @param string $customerName Your name or business name, or that of your
+     *                             customer.
+     * @param string $street The number and street address where you or your
+     *                       customer is located.
+     * @param string $city The city in which you or your customer is located.
+     * @param string $region The state or region in which you or your customer is
+     *                       located.
+     * @param string $postalCode The postal code in which you or your customer is
+     *                           located.
      * @param boolean $emergencyEnabled The emergency_enabled
-     * @param boolean $autoCorrectAddress The auto_correct_address
+     * @param boolean $autoCorrectAddress If you don't set a value for this
+     *                                    parameter, or if you set it to true, then
+     *                                    the system will, if necessary,
+     *                                    auto-correct the address you provide.
      * @return UpdateAddressOptions Options builder
      */
     public static function update($friendlyName = Values::NONE, $customerName = Values::NONE, $street = Values::NONE, $city = Values::NONE, $region = Values::NONE, $postalCode = Values::NONE, $emergencyEnabled = Values::NONE, $autoCorrectAddress = Values::NONE) {
@@ -39,9 +49,11 @@ abstract class AddressOptions {
     }
 
     /**
-     * @param string $customerName The customer_name
-     * @param string $friendlyName The friendly_name
-     * @param string $isoCountry The iso_country
+     * @param string $customerName Only return the Address resources with customer
+     *                             names that exactly match this name.
+     * @param string $friendlyName Only return the Address resources with friendly
+     *                             names that exactly match this name.
+     * @param string $isoCountry Only return the Address resources in this country.
      * @return ReadAddressOptions Options builder
      */
     public static function read($customerName = Values::NONE, $friendlyName = Values::NONE, $isoCountry = Values::NONE) {
@@ -51,9 +63,12 @@ abstract class AddressOptions {
 
 class CreateAddressOptions extends Options {
     /**
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A human-readable description of the new address.
      * @param boolean $emergencyEnabled The emergency_enabled
-     * @param boolean $autoCorrectAddress The auto_correct_address
+     * @param boolean $autoCorrectAddress If you don't set a value for this
+     *                                    parameter, or if you set it to true, then
+     *                                    the system will, if necessary,
+     *                                    auto-correct the address you provide.
      */
     public function __construct($friendlyName = Values::NONE, $emergencyEnabled = Values::NONE, $autoCorrectAddress = Values::NONE) {
         $this->options['friendlyName'] = $friendlyName;
@@ -62,9 +77,9 @@ class CreateAddressOptions extends Options {
     }
 
     /**
-     * The friendly_name
+     * A human-readable description of the new address. Maximum 64 characters.
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A human-readable description of the new address.
      * @return $this Fluent Builder
      */
     public function setFriendlyName($friendlyName) {
@@ -84,9 +99,12 @@ class CreateAddressOptions extends Options {
     }
 
     /**
-     * The auto_correct_address
+     * If you don't set a value for this parameter, or if you set it to `true`, then the system will, if necessary, auto-correct the address you provide. If you don't want the system to auto-correct the address, you will explicitly need to set this value to `false`.
      * 
-     * @param boolean $autoCorrectAddress The auto_correct_address
+     * @param boolean $autoCorrectAddress If you don't set a value for this
+     *                                    parameter, or if you set it to true, then
+     *                                    the system will, if necessary,
+     *                                    auto-correct the address you provide.
      * @return $this Fluent Builder
      */
     public function setAutoCorrectAddress($autoCorrectAddress) {
@@ -112,14 +130,21 @@ class CreateAddressOptions extends Options {
 
 class UpdateAddressOptions extends Options {
     /**
-     * @param string $friendlyName The friendly_name
-     * @param string $customerName The customer_name
-     * @param string $street The street
-     * @param string $city The city
-     * @param string $region The region
-     * @param string $postalCode The postal_code
+     * @param string $friendlyName A human-readable description of the address.
+     * @param string $customerName Your name or business name, or that of your
+     *                             customer.
+     * @param string $street The number and street address where you or your
+     *                       customer is located.
+     * @param string $city The city in which you or your customer is located.
+     * @param string $region The state or region in which you or your customer is
+     *                       located.
+     * @param string $postalCode The postal code in which you or your customer is
+     *                           located.
      * @param boolean $emergencyEnabled The emergency_enabled
-     * @param boolean $autoCorrectAddress The auto_correct_address
+     * @param boolean $autoCorrectAddress If you don't set a value for this
+     *                                    parameter, or if you set it to true, then
+     *                                    the system will, if necessary,
+     *                                    auto-correct the address you provide.
      */
     public function __construct($friendlyName = Values::NONE, $customerName = Values::NONE, $street = Values::NONE, $city = Values::NONE, $region = Values::NONE, $postalCode = Values::NONE, $emergencyEnabled = Values::NONE, $autoCorrectAddress = Values::NONE) {
         $this->options['friendlyName'] = $friendlyName;
@@ -133,9 +158,9 @@ class UpdateAddressOptions extends Options {
     }
 
     /**
-     * The friendly_name
+     * A human-readable description of the address. Maximum 64 characters.
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A human-readable description of the address.
      * @return $this Fluent Builder
      */
     public function setFriendlyName($friendlyName) {
@@ -144,9 +169,10 @@ class UpdateAddressOptions extends Options {
     }
 
     /**
-     * The customer_name
+     * Your name or business name, or that of your customer.
      * 
-     * @param string $customerName The customer_name
+     * @param string $customerName Your name or business name, or that of your
+     *                             customer.
      * @return $this Fluent Builder
      */
     public function setCustomerName($customerName) {
@@ -155,9 +181,10 @@ class UpdateAddressOptions extends Options {
     }
 
     /**
-     * The street
+     * The number and street address where you or your customer is located.
      * 
-     * @param string $street The street
+     * @param string $street The number and street address where you or your
+     *                       customer is located.
      * @return $this Fluent Builder
      */
     public function setStreet($street) {
@@ -166,9 +193,9 @@ class UpdateAddressOptions extends Options {
     }
 
     /**
-     * The city
+     * The city in which you or your customer is located.
      * 
-     * @param string $city The city
+     * @param string $city The city in which you or your customer is located.
      * @return $this Fluent Builder
      */
     public function setCity($city) {
@@ -177,9 +204,10 @@ class UpdateAddressOptions extends Options {
     }
 
     /**
-     * The region
+     * The state or region in which you or your customer is located.
      * 
-     * @param string $region The region
+     * @param string $region The state or region in which you or your customer is
+     *                       located.
      * @return $this Fluent Builder
      */
     public function setRegion($region) {
@@ -188,9 +216,10 @@ class UpdateAddressOptions extends Options {
     }
 
     /**
-     * The postal_code
+     * The postal code in which you or your customer is located.
      * 
-     * @param string $postalCode The postal_code
+     * @param string $postalCode The postal code in which you or your customer is
+     *                           located.
      * @return $this Fluent Builder
      */
     public function setPostalCode($postalCode) {
@@ -210,9 +239,12 @@ class UpdateAddressOptions extends Options {
     }
 
     /**
-     * The auto_correct_address
+     * If you don't set a value for this parameter, or if you set it to `true`, then the system will, if necessary, auto-correct the address you provide. If you don't want the system to auto-correct the address, you will explicitly need to set this value to `false`.
      * 
-     * @param boolean $autoCorrectAddress The auto_correct_address
+     * @param boolean $autoCorrectAddress If you don't set a value for this
+     *                                    parameter, or if you set it to true, then
+     *                                    the system will, if necessary,
+     *                                    auto-correct the address you provide.
      * @return $this Fluent Builder
      */
     public function setAutoCorrectAddress($autoCorrectAddress) {
@@ -238,9 +270,11 @@ class UpdateAddressOptions extends Options {
 
 class ReadAddressOptions extends Options {
     /**
-     * @param string $customerName The customer_name
-     * @param string $friendlyName The friendly_name
-     * @param string $isoCountry The iso_country
+     * @param string $customerName Only return the Address resources with customer
+     *                             names that exactly match this name.
+     * @param string $friendlyName Only return the Address resources with friendly
+     *                             names that exactly match this name.
+     * @param string $isoCountry Only return the Address resources in this country.
      */
     public function __construct($customerName = Values::NONE, $friendlyName = Values::NONE, $isoCountry = Values::NONE) {
         $this->options['customerName'] = $customerName;
@@ -249,9 +283,10 @@ class ReadAddressOptions extends Options {
     }
 
     /**
-     * The customer_name
+     * Only return the Address resources with customer names that exactly match this name.
      * 
-     * @param string $customerName The customer_name
+     * @param string $customerName Only return the Address resources with customer
+     *                             names that exactly match this name.
      * @return $this Fluent Builder
      */
     public function setCustomerName($customerName) {
@@ -260,9 +295,10 @@ class ReadAddressOptions extends Options {
     }
 
     /**
-     * The friendly_name
+     * Only return the Address resources with friendly names that exactly match this name.
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName Only return the Address resources with friendly
+     *                             names that exactly match this name.
      * @return $this Fluent Builder
      */
     public function setFriendlyName($friendlyName) {
@@ -271,9 +307,9 @@ class ReadAddressOptions extends Options {
     }
 
     /**
-     * The iso_country
+     * Only return the Address resources in this country.
      * 
-     * @param string $isoCountry The iso_country
+     * @param string $isoCountry Only return the Address resources in this country.
      * @return $this Fluent Builder
      */
     public function setIsoCountry($isoCountry) {

plugins/Twilio/Rest/Api/V2010/Account/AddressPage.php

@@ -37,6 +37,7 @@ class ApplicationContext extends InstanceContext {
      * Deletes the ApplicationInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);
@@ -46,6 +47,7 @@ class ApplicationContext extends InstanceContext {
      * Fetch a ApplicationInstance
      * 
      * @return ApplicationInstance Fetched ApplicationInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -69,6 +71,7 @@ class ApplicationContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return ApplicationInstance Updated ApplicationInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/ApplicationInstance.php

@@ -101,6 +101,7 @@ class ApplicationInstance extends InstanceResource {
      * Deletes the ApplicationInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();
@@ -110,6 +111,7 @@ class ApplicationInstance extends InstanceResource {
      * Fetch a ApplicationInstance
      * 
      * @return ApplicationInstance Fetched ApplicationInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -120,6 +122,7 @@ class ApplicationInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return ApplicationInstance Updated ApplicationInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);

plugins/Twilio/Rest/Api/V2010/Account/ApplicationList.php

@@ -35,9 +35,10 @@ class ApplicationList extends ListResource {
     /**
      * Create a new ApplicationInstance
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A human readable description of the application
      * @param array|Options $options Optional Arguments
      * @return ApplicationInstance Newly created ApplicationInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($friendlyName, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/ApplicationOptions.php

@@ -109,7 +109,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * Requests to this application will start a new TwiML session with this API version.
+     * Requests to this application's URLs will start a new TwiML session with this API version. Either `2010-04-01` or `2008-08-01`. Defaults to your account's default API version.
      * 
      * @param string $apiVersion The API version to use
      * @return $this Fluent Builder
@@ -120,7 +120,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * The URL Twilio will request when a phone number assigned to this application receives a call.
+     * The URL that Twilio should request when somebody dials a phone number assigned to this application.
      * 
      * @param string $voiceUrl URL Twilio will make requests to when relieving a
      *                         call
@@ -132,7 +132,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use when requesting the above `Url`. Either `GET` or `POST`.
+     * The HTTP method that should be used to request the `VoiceUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
      * @param string $voiceMethod HTTP method to use with the URL
      * @return $this Fluent Builder
@@ -154,7 +154,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use when requesting the `VoiceFallbackUrl`. Either `GET` or `POST`.
+     * The HTTP method that should be used to request the `VoiceFallbackUrl`. Either `GET` or `POST`. Defaults to `POST`.
      * 
      * @param string $voiceFallbackMethod HTTP method to use with the fallback url
      * @return $this Fluent Builder
@@ -176,7 +176,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use to make requests to the `StatusCallback` URL. Either `GET` or `POST`.
+     * The HTTP method Twilio will use to make requests to the `StatusCallback` URL. Either `GET` or `POST`. Defaults to `POST`.
      * 
      * @param string $statusCallbackMethod HTTP method to use with the status
      *                                     callback
@@ -188,7 +188,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * Look up the caller's caller-ID name from the CNAM database (additional charges apply). Either `true` or `false`.
+     * Do a lookup of a caller's name from the CNAM database and post it to your app. Either `true` or `false`. Defaults to `false`.
      * 
      * @param boolean $voiceCallerIdLookup True or False
      * @return $this Fluent Builder
@@ -210,7 +210,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use when making requests to the `SmsUrl`. Either `GET` or `POST`.
+     * The HTTP method that should be used to request the `SmsUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
      * @param string $smsMethod HTTP method to use with sms_url
      * @return $this Fluent Builder
@@ -221,7 +221,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * The URL that Twilio will request if an error occurs retrieving or executing the TwiML from `SmsUrl`.
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML defined by `SmsUrl`.
      * 
      * @param string $smsFallbackUrl Fallback URL if there's an error parsing TwiML
      * @return $this Fluent Builder
@@ -232,7 +232,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use when requesting the above URL. Either `GET` or `POST`.
+     * The HTTP method that should be used to request the `SmsFallbackUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
      * @param string $smsFallbackMethod HTTP method to use with sms_fallback_method
      * @return $this Fluent Builder
@@ -243,7 +243,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * The URL that Twilio will `POST` to when a message is sent via the `/SMS/Messages` endpoint if you specify the `Sid` of this application on an outgoing SMS request.
+     * Twilio will make a `POST` request to this URL to pass status parameters (such as sent or failed) to your application if you specify this application's `Sid` as the `ApplicationSid` on an [outgoing SMS request](https://www.twilio.com/docs/sms/send-messages).
      * 
      * @param string $smsStatusCallback URL Twilio with request with status updates
      * @return $this Fluent Builder
@@ -254,7 +254,7 @@ class CreateApplicationOptions extends Options {
     }
 
     /**
-     * Twilio will make a `POST` request to this URL to pass status parameters (such as sent or failed) to your application if you use the `/Messages` endpoint to send the message and specify this application's `Sid` as the `ApplicationSid` on an outgoing SMS request.
+     * Twilio will make a `POST` request to this URL to pass status parameters (such as sent or failed) to your application if you use the `/Messages` endpoint to send the message and specify this application's `Sid` as the `ApplicationSid` on an [outgoing SMS request](https://www.twilio.com/docs/sms/send-messages).
      * 
      * @param string $messageStatusCallback URL to make requests to with status
      *                                      updates
@@ -356,7 +356,7 @@ class UpdateApplicationOptions extends Options {
     }
 
     /**
-     * A human readable descriptive text for this resource, up to 64 characters long.
+     * A human readable description of the application, with maximum length 64 characters.
      * 
      * @param string $friendlyName Human readable description of this resource
      * @return $this Fluent Builder
@@ -367,7 +367,7 @@ class UpdateApplicationOptions extends Options {
     }
 
     /**
-     * Requests to this application will start a new TwiML session with this API version.
+     * Requests to this application's URLs will start a new TwiML session with this API version. Either `2010-04-01` or `2008-08-01`.
      * 
      * @param string $apiVersion The API version to use
      * @return $this Fluent Builder
@@ -378,7 +378,7 @@ class UpdateApplicationOptions extends Options {
     }
 
     /**
-     * The URL Twilio will request when a phone number assigned to this application receives a call.
+     * The URL that Twilio should request when somebody dials a phone number assigned to this application.
      * 
      * @param string $voiceUrl URL Twilio will make requests to when relieving a
      *                         call
@@ -401,7 +401,7 @@ class UpdateApplicationOptions extends Options {
     }
 
     /**
-     * The URL that Twilio will request if an error occurs retrieving or executing the TwiML requested by `Url`.
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML defined by `VoiceUrl`.
      * 
      * @param string $voiceFallbackUrl Fallback URL
      * @return $this Fluent Builder
@@ -479,7 +479,7 @@ class UpdateApplicationOptions extends Options {
     }
 
     /**
-     * The URL that Twilio will request if an error occurs retrieving or executing the TwiML from `SmsUrl`.
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML defined by `SmsUrl`.
      * 
      * @param string $smsFallbackUrl Fallback URL if there's an error parsing TwiML
      * @return $this Fluent Builder
@@ -490,7 +490,7 @@ class UpdateApplicationOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use when requesting the above URL. Either `GET` or `POST`.
+     * The HTTP method that should be used to request the `SmsFallbackUrl`. Either `GET` or `POST`.
      * 
      * @param string $smsFallbackMethod HTTP method to use with sms_fallback_method
      * @return $this Fluent Builder
@@ -501,7 +501,7 @@ class UpdateApplicationOptions extends Options {
     }
 
     /**
-     * The URL that Twilio will `POST` to when a message is sent via the `/SMS/Messages` endpoint if you specify the `Sid` of this application on an outgoing SMS request.
+     * The URL that Twilio will `POST` to when a message is sent via the `/SMS/Messages` endpoint if you specify the `Sid` of this application on an [outgoing SMS request](https://www.twilio.com/docs/sms/send-messages).
      * 
      * @param string $smsStatusCallback URL Twilio with request with status updates
      * @return $this Fluent Builder
@@ -512,7 +512,7 @@ class UpdateApplicationOptions extends Options {
     }
 
     /**
-     * Twilio will make a `POST` request to this URL to pass status parameters (such as sent or failed) to your application if you use the `/Messages` endpoint to send the message and specify this application's `Sid` as the `ApplicationSid` on an outgoing SMS request.
+     * Twilio will make a `POST` request to this URL to pass status parameters (such as sent or failed) to your application if you use the `/Messages` endpoint to send the message and specify this application's `Sid` as the `ApplicationSid` on an [outgoing SMS request](https://www.twilio.com/docs/sms/send-messages).
      * 
      * @param string $messageStatusCallback URL to make requests to with status
      *                                      updates

plugins/Twilio/Rest/Api/V2010/Account/ApplicationPage.php

@@ -35,6 +35,7 @@ class AuthorizedConnectAppContext extends InstanceContext {
      * Fetch a AuthorizedConnectAppInstance
      * 
      * @return AuthorizedConnectAppInstance Fetched AuthorizedConnectAppInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());

plugins/Twilio/Rest/Api/V2010/Account/AuthorizedConnectAppInstance.php

@@ -84,6 +84,7 @@ class AuthorizedConnectAppInstance extends InstanceResource {
      * Fetch a AuthorizedConnectAppInstance
      * 
      * @return AuthorizedConnectAppInstance Fetched AuthorizedConnectAppInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();

plugins/Twilio/Rest/Api/V2010/Account/AuthorizedConnectAppList.php

@@ -14,26 +14,44 @@ use Twilio\Values;
 
 abstract class LocalOptions {
     /**
-     * @param integer $areaCode The area_code
-     * @param string $contains The contains
-     * @param boolean $smsEnabled The sms_enabled
-     * @param boolean $mmsEnabled The mms_enabled
-     * @param boolean $voiceEnabled The voice_enabled
-     * @param boolean $excludeAllAddressRequired The exclude_all_address_required
-     * @param boolean $excludeLocalAddressRequired The
-     *                                             exclude_local_address_required
-     * @param boolean $excludeForeignAddressRequired The
-     *                                               exclude_foreign_address_required
-     * @param boolean $beta The beta
-     * @param string $nearNumber The near_number
-     * @param string $nearLatLong The near_lat_long
-     * @param integer $distance The distance
-     * @param string $inPostalCode The in_postal_code
-     * @param string $inRegion The in_region
-     * @param string $inRateCenter The in_rate_center
-     * @param string $inLata The in_lata
-     * @param string $inLocality The in_locality
-     * @param boolean $faxEnabled The fax_enabled
+     * @param integer $areaCode Find phone numbers in the specified area code.
+     * @param string $contains A pattern on which to match phone numbers.
+     * @param boolean $smsEnabled This indicates whether the phone numbers can
+     *                            receive text messages.
+     * @param boolean $mmsEnabled This indicates whether the phone numbers can
+     *                            receive MMS messages.
+     * @param boolean $voiceEnabled This indicates whether the phone numbers can
+     *                              receive calls.
+     * @param boolean $excludeAllAddressRequired Indicates whether the response
+     *                                           includes phone numbers which
+     *                                           require any Address.
+     * @param boolean $excludeLocalAddressRequired Indicates whether the response
+     *                                             includes phone numbers which
+     *                                             require a local Address.
+     * @param boolean $excludeForeignAddressRequired Indicates whether the response
+     *                                               includes phone numbers which
+     *                                               require a foreign Address.
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $nearNumber Given a phone number, find a geographically close
+     *                           number within Distance miles. (US/Canada only)
+     * @param string $nearLatLong Given a latitude/longitude pair lat,long find
+     *                            geographically close numbers within Distance
+     *                            miles. (US/Canada only)
+     * @param integer $distance Specifies the search radius for a Near- query in
+     *                          miles. (US/Canada only)
+     * @param string $inPostalCode Limit results to a particular postal code.
+     *                             (US/Canada only)
+     * @param string $inRegion Limit results to a particular region. (US/Canada
+     *                         only)
+     * @param string $inRateCenter Limit results to a specific rate center, or
+     *                             given a phone number search within the same rate
+     *                             center as that number. (US/Canada only)
+     * @param string $inLata Limit results to a specific Local access and transport
+     *                       area. (US/Canada only)
+     * @param string $inLocality Limit results to a particular locality. (US/Canada
+     *                           only)
+     * @param boolean $faxEnabled This indicates whether the phone numbers can
+     *                            receive faxes.
      * @return ReadLocalOptions Options builder
      */
     public static function read($areaCode = Values::NONE, $contains = Values::NONE, $smsEnabled = Values::NONE, $mmsEnabled = Values::NONE, $voiceEnabled = Values::NONE, $excludeAllAddressRequired = Values::NONE, $excludeLocalAddressRequired = Values::NONE, $excludeForeignAddressRequired = Values::NONE, $beta = Values::NONE, $nearNumber = Values::NONE, $nearLatLong = Values::NONE, $distance = Values::NONE, $inPostalCode = Values::NONE, $inRegion = Values::NONE, $inRateCenter = Values::NONE, $inLata = Values::NONE, $inLocality = Values::NONE, $faxEnabled = Values::NONE) {
@@ -43,26 +61,44 @@ abstract class LocalOptions {
 
 class ReadLocalOptions extends Options {
     /**
-     * @param integer $areaCode The area_code
-     * @param string $contains The contains
-     * @param boolean $smsEnabled The sms_enabled
-     * @param boolean $mmsEnabled The mms_enabled
-     * @param boolean $voiceEnabled The voice_enabled
-     * @param boolean $excludeAllAddressRequired The exclude_all_address_required
-     * @param boolean $excludeLocalAddressRequired The
-     *                                             exclude_local_address_required
-     * @param boolean $excludeForeignAddressRequired The
-     *                                               exclude_foreign_address_required
-     * @param boolean $beta The beta
-     * @param string $nearNumber The near_number
-     * @param string $nearLatLong The near_lat_long
-     * @param integer $distance The distance
-     * @param string $inPostalCode The in_postal_code
-     * @param string $inRegion The in_region
-     * @param string $inRateCenter The in_rate_center
-     * @param string $inLata The in_lata
-     * @param string $inLocality The in_locality
-     * @param boolean $faxEnabled The fax_enabled
+     * @param integer $areaCode Find phone numbers in the specified area code.
+     * @param string $contains A pattern on which to match phone numbers.
+     * @param boolean $smsEnabled This indicates whether the phone numbers can
+     *                            receive text messages.
+     * @param boolean $mmsEnabled This indicates whether the phone numbers can
+     *                            receive MMS messages.
+     * @param boolean $voiceEnabled This indicates whether the phone numbers can
+     *                              receive calls.
+     * @param boolean $excludeAllAddressRequired Indicates whether the response
+     *                                           includes phone numbers which
+     *                                           require any Address.
+     * @param boolean $excludeLocalAddressRequired Indicates whether the response
+     *                                             includes phone numbers which
+     *                                             require a local Address.
+     * @param boolean $excludeForeignAddressRequired Indicates whether the response
+     *                                               includes phone numbers which
+     *                                               require a foreign Address.
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $nearNumber Given a phone number, find a geographically close
+     *                           number within Distance miles. (US/Canada only)
+     * @param string $nearLatLong Given a latitude/longitude pair lat,long find
+     *                            geographically close numbers within Distance
+     *                            miles. (US/Canada only)
+     * @param integer $distance Specifies the search radius for a Near- query in
+     *                          miles. (US/Canada only)
+     * @param string $inPostalCode Limit results to a particular postal code.
+     *                             (US/Canada only)
+     * @param string $inRegion Limit results to a particular region. (US/Canada
+     *                         only)
+     * @param string $inRateCenter Limit results to a specific rate center, or
+     *                             given a phone number search within the same rate
+     *                             center as that number. (US/Canada only)
+     * @param string $inLata Limit results to a specific Local access and transport
+     *                       area. (US/Canada only)
+     * @param string $inLocality Limit results to a particular locality. (US/Canada
+     *                           only)
+     * @param boolean $faxEnabled This indicates whether the phone numbers can
+     *                            receive faxes.
      */
     public function __construct($areaCode = Values::NONE, $contains = Values::NONE, $smsEnabled = Values::NONE, $mmsEnabled = Values::NONE, $voiceEnabled = Values::NONE, $excludeAllAddressRequired = Values::NONE, $excludeLocalAddressRequired = Values::NONE, $excludeForeignAddressRequired = Values::NONE, $beta = Values::NONE, $nearNumber = Values::NONE, $nearLatLong = Values::NONE, $distance = Values::NONE, $inPostalCode = Values::NONE, $inRegion = Values::NONE, $inRateCenter = Values::NONE, $inLata = Values::NONE, $inLocality = Values::NONE, $faxEnabled = Values::NONE) {
         $this->options['areaCode'] = $areaCode;
@@ -86,9 +122,9 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The area_code
+     * Find phone numbers in the specified area code. (US and Canada only)
      * 
-     * @param integer $areaCode The area_code
+     * @param integer $areaCode Find phone numbers in the specified area code.
      * @return $this Fluent Builder
      */
     public function setAreaCode($areaCode) {
@@ -97,9 +133,9 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The contains
+     * A pattern on which to match phone numbers. Valid characters are `'*'` and `[0-9a-zA-Z]`. The `'*'` character will match any single digit. See [Example 2](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-3) below. *NOTE:* Patterns must be at least two characters long.
      * 
-     * @param string $contains The contains
+     * @param string $contains A pattern on which to match phone numbers.
      * @return $this Fluent Builder
      */
     public function setContains($contains) {
@@ -108,9 +144,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The sms_enabled
+     * This indicates whether the phone numbers can receive text messages. Possible values are `true` or `false`.
      * 
-     * @param boolean $smsEnabled The sms_enabled
+     * @param boolean $smsEnabled This indicates whether the phone numbers can
+     *                            receive text messages.
      * @return $this Fluent Builder
      */
     public function setSmsEnabled($smsEnabled) {
@@ -119,9 +156,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The mms_enabled
+     * This indicates whether the phone numbers can receive MMS messages. Possible values are `true` or `false`.
      * 
-     * @param boolean $mmsEnabled The mms_enabled
+     * @param boolean $mmsEnabled This indicates whether the phone numbers can
+     *                            receive MMS messages.
      * @return $this Fluent Builder
      */
     public function setMmsEnabled($mmsEnabled) {
@@ -130,9 +168,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The voice_enabled
+     * This indicates whether the phone numbers can receive calls. Possible values are `true` or `false`.
      * 
-     * @param boolean $voiceEnabled The voice_enabled
+     * @param boolean $voiceEnabled This indicates whether the phone numbers can
+     *                              receive calls.
      * @return $this Fluent Builder
      */
     public function setVoiceEnabled($voiceEnabled) {
@@ -141,9 +180,11 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The exclude_all_address_required
+     * Indicates whether the response includes phone numbers which require any [Address](https://www.twilio.com/docs/usage/api/addresses). Possible values are `true` or `false`. If not specified, the default is `false`, and results could include phone numbers with an Address required.
      * 
-     * @param boolean $excludeAllAddressRequired The exclude_all_address_required
+     * @param boolean $excludeAllAddressRequired Indicates whether the response
+     *                                           includes phone numbers which
+     *                                           require any Address.
      * @return $this Fluent Builder
      */
     public function setExcludeAllAddressRequired($excludeAllAddressRequired) {
@@ -152,10 +193,11 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The exclude_local_address_required
+     * Indicates whether the response includes phone numbers which require a local [Address](https://www.twilio.com/docs/usage/api/addresses). Possible values are `true` or `false`. If not specified, the default is `false`, and results could include phone numbers with a local Address required.
      * 
-     * @param boolean $excludeLocalAddressRequired The
-     *                                             exclude_local_address_required
+     * @param boolean $excludeLocalAddressRequired Indicates whether the response
+     *                                             includes phone numbers which
+     *                                             require a local Address.
      * @return $this Fluent Builder
      */
     public function setExcludeLocalAddressRequired($excludeLocalAddressRequired) {
@@ -164,10 +206,11 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The exclude_foreign_address_required
+     * Indicates whether the response includes phone numbers which require a foreign [Address](https://www.twilio.com/docs/usage/api/addresses). Possible values are `true` or `false`. If not specified, the default is `false`, and results could include phone numbers with a foreign Address required.
      * 
-     * @param boolean $excludeForeignAddressRequired The
-     *                                               exclude_foreign_address_required
+     * @param boolean $excludeForeignAddressRequired Indicates whether the response
+     *                                               includes phone numbers which
+     *                                               require a foreign Address.
      * @return $this Fluent Builder
      */
     public function setExcludeForeignAddressRequired($excludeForeignAddressRequired) {
@@ -176,9 +219,9 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The beta
+     * Include phone numbers new to the Twilio platform. Possible values are either `true` or `false`. Default is `true`.
      * 
-     * @param boolean $beta The beta
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
      * @return $this Fluent Builder
      */
     public function setBeta($beta) {
@@ -187,9 +230,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The near_number
+     * Given a phone number, find a geographically close number within `Distance` miles. Distance defaults to 25 miles. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $nearNumber The near_number
+     * @param string $nearNumber Given a phone number, find a geographically close
+     *                           number within Distance miles. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setNearNumber($nearNumber) {
@@ -198,9 +242,11 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The near_lat_long
+     * Given a latitude/longitude pair `lat,long` find geographically close numbers within `Distance` miles. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $nearLatLong The near_lat_long
+     * @param string $nearLatLong Given a latitude/longitude pair lat,long find
+     *                            geographically close numbers within Distance
+     *                            miles. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setNearLatLong($nearLatLong) {
@@ -209,9 +255,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The distance
+     * Specifies the search radius for a `Near-` query in miles. If not specified this defaults to 25 miles. Maximum searchable distance is 500 miles. *Limited to US and Canadian phone numbers.*
      * 
-     * @param integer $distance The distance
+     * @param integer $distance Specifies the search radius for a Near- query in
+     *                          miles. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setDistance($distance) {
@@ -220,9 +267,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The in_postal_code
+     * Limit results to a particular postal code. Given a phone number, search within the same postal code as that number. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inPostalCode The in_postal_code
+     * @param string $inPostalCode Limit results to a particular postal code.
+     *                             (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setInPostalCode($inPostalCode) {
@@ -231,9 +279,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The in_region
+     * Limit results to a particular region (i.e.  State/Province). Given a phone number, search within the same Region as that number. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inRegion The in_region
+     * @param string $inRegion Limit results to a particular region. (US/Canada
+     *                         only)
      * @return $this Fluent Builder
      */
     public function setInRegion($inRegion) {
@@ -242,9 +291,11 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The in_rate_center
+     * Limit results to a specific rate center, or given a phone number search within the same rate center as that number. Requires InLata to be set as well. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inRateCenter The in_rate_center
+     * @param string $inRateCenter Limit results to a specific rate center, or
+     *                             given a phone number search within the same rate
+     *                             center as that number. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setInRateCenter($inRateCenter) {
@@ -253,9 +304,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The in_lata
+     * Limit results to a specific Local access and transport area ([LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area)). Given a phone number, search within the same [LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area) as that number. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inLata The in_lata
+     * @param string $inLata Limit results to a specific Local access and transport
+     *                       area. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setInLata($inLata) {
@@ -264,9 +316,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The in_locality
+     * Limit results to a particular locality (i.e.  City). Given a phone number, search within the same Locality as that number. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inLocality The in_locality
+     * @param string $inLocality Limit results to a particular locality. (US/Canada
+     *                           only)
      * @return $this Fluent Builder
      */
     public function setInLocality($inLocality) {
@@ -275,9 +328,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The fax_enabled
+     * This indicates whether the phone numbers can receive faxes. Possible values are `true` or `false`.
      * 
-     * @param boolean $faxEnabled The fax_enabled
+     * @param boolean $faxEnabled This indicates whether the phone numbers can
+     *                            receive faxes.
      * @return $this Fluent Builder
      */
     public function setFaxEnabled($faxEnabled) {

plugins/Twilio/Rest/Api/V2010/Account/AvailablePhoneNumberCountry/LocalPage.php

@@ -14,26 +14,43 @@ use Twilio\Values;
 
 abstract class MobileOptions {
     /**
-     * @param integer $areaCode The area_code
-     * @param string $contains The contains
-     * @param boolean $smsEnabled The sms_enabled
-     * @param boolean $mmsEnabled The mms_enabled
-     * @param boolean $voiceEnabled The voice_enabled
-     * @param boolean $excludeAllAddressRequired The exclude_all_address_required
-     * @param boolean $excludeLocalAddressRequired The
-     *                                             exclude_local_address_required
-     * @param boolean $excludeForeignAddressRequired The
-     *                                               exclude_foreign_address_required
-     * @param boolean $beta The beta
-     * @param string $nearNumber The near_number
-     * @param string $nearLatLong The near_lat_long
-     * @param integer $distance The distance
-     * @param string $inPostalCode The in_postal_code
-     * @param string $inRegion The in_region
-     * @param string $inRateCenter The in_rate_center
-     * @param string $inLata The in_lata
-     * @param string $inLocality The in_locality
-     * @param boolean $faxEnabled The fax_enabled
+     * @param integer $areaCode Find phone numbers in the specified area code.
+     * @param string $contains A pattern on which to match phone numbers.
+     * @param boolean $smsEnabled This indicates whether the phone numbers can
+     *                            receive text messages.
+     * @param boolean $mmsEnabled This indicates whether the phone numbers can
+     *                            receive MMS messages.
+     * @param boolean $voiceEnabled This indicates whether the phone numbers can
+     *                              receive calls.
+     * @param boolean $excludeAllAddressRequired Indicates whether the response
+     *                                           includes phone numbers which
+     *                                           require any Address.
+     * @param boolean $excludeLocalAddressRequired Indicates whether the response
+     *                                             includes phone numbers which
+     *                                             require a local Address.
+     * @param boolean $excludeForeignAddressRequired Indicates whether the response
+     *                                               includes phone numbers which
+     *                                               require a foreign Address.
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $nearNumber Given a phone number, find a geographically close
+     *                           number within Distance miles. (US/Canada only)
+     * @param string $nearLatLong Given a latitude/longitude pair lat,long find
+     *                            geographically close numbers within Distance
+     *                            miles. (US/Canada only)
+     * @param integer $distance Specifies the search radius for a Near- query in
+     *                          miles. (US/Canada only)
+     * @param string $inPostalCode Limit results to a particular postal code.
+     *                             (US/Canada only)
+     * @param string $inRegion Limit results to a particular region. (US/Canada
+     *                         only)
+     * @param string $inRateCenter Limit results to a specific rate center, or
+     *                             given a phone number search within the same rate
+     *                             center as that number. (US/Canada only)
+     * @param string $inLata Limit results to a specific Local access and transport
+     *                       area. (US/Canada only)
+     * @param string $inLocality Limit results to a particular locality.
+     * @param boolean $faxEnabled This indicates whether the phone numbers can
+     *                            receive faxes.
      * @return ReadMobileOptions Options builder
      */
     public static function read($areaCode = Values::NONE, $contains = Values::NONE, $smsEnabled = Values::NONE, $mmsEnabled = Values::NONE, $voiceEnabled = Values::NONE, $excludeAllAddressRequired = Values::NONE, $excludeLocalAddressRequired = Values::NONE, $excludeForeignAddressRequired = Values::NONE, $beta = Values::NONE, $nearNumber = Values::NONE, $nearLatLong = Values::NONE, $distance = Values::NONE, $inPostalCode = Values::NONE, $inRegion = Values::NONE, $inRateCenter = Values::NONE, $inLata = Values::NONE, $inLocality = Values::NONE, $faxEnabled = Values::NONE) {
@@ -43,26 +60,43 @@ abstract class MobileOptions {
 
 class ReadMobileOptions extends Options {
     /**
-     * @param integer $areaCode The area_code
-     * @param string $contains The contains
-     * @param boolean $smsEnabled The sms_enabled
-     * @param boolean $mmsEnabled The mms_enabled
-     * @param boolean $voiceEnabled The voice_enabled
-     * @param boolean $excludeAllAddressRequired The exclude_all_address_required
-     * @param boolean $excludeLocalAddressRequired The
-     *                                             exclude_local_address_required
-     * @param boolean $excludeForeignAddressRequired The
-     *                                               exclude_foreign_address_required
-     * @param boolean $beta The beta
-     * @param string $nearNumber The near_number
-     * @param string $nearLatLong The near_lat_long
-     * @param integer $distance The distance
-     * @param string $inPostalCode The in_postal_code
-     * @param string $inRegion The in_region
-     * @param string $inRateCenter The in_rate_center
-     * @param string $inLata The in_lata
-     * @param string $inLocality The in_locality
-     * @param boolean $faxEnabled The fax_enabled
+     * @param integer $areaCode Find phone numbers in the specified area code.
+     * @param string $contains A pattern on which to match phone numbers.
+     * @param boolean $smsEnabled This indicates whether the phone numbers can
+     *                            receive text messages.
+     * @param boolean $mmsEnabled This indicates whether the phone numbers can
+     *                            receive MMS messages.
+     * @param boolean $voiceEnabled This indicates whether the phone numbers can
+     *                              receive calls.
+     * @param boolean $excludeAllAddressRequired Indicates whether the response
+     *                                           includes phone numbers which
+     *                                           require any Address.
+     * @param boolean $excludeLocalAddressRequired Indicates whether the response
+     *                                             includes phone numbers which
+     *                                             require a local Address.
+     * @param boolean $excludeForeignAddressRequired Indicates whether the response
+     *                                               includes phone numbers which
+     *                                               require a foreign Address.
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $nearNumber Given a phone number, find a geographically close
+     *                           number within Distance miles. (US/Canada only)
+     * @param string $nearLatLong Given a latitude/longitude pair lat,long find
+     *                            geographically close numbers within Distance
+     *                            miles. (US/Canada only)
+     * @param integer $distance Specifies the search radius for a Near- query in
+     *                          miles. (US/Canada only)
+     * @param string $inPostalCode Limit results to a particular postal code.
+     *                             (US/Canada only)
+     * @param string $inRegion Limit results to a particular region. (US/Canada
+     *                         only)
+     * @param string $inRateCenter Limit results to a specific rate center, or
+     *                             given a phone number search within the same rate
+     *                             center as that number. (US/Canada only)
+     * @param string $inLata Limit results to a specific Local access and transport
+     *                       area. (US/Canada only)
+     * @param string $inLocality Limit results to a particular locality.
+     * @param boolean $faxEnabled This indicates whether the phone numbers can
+     *                            receive faxes.
      */
     public function __construct($areaCode = Values::NONE, $contains = Values::NONE, $smsEnabled = Values::NONE, $mmsEnabled = Values::NONE, $voiceEnabled = Values::NONE, $excludeAllAddressRequired = Values::NONE, $excludeLocalAddressRequired = Values::NONE, $excludeForeignAddressRequired = Values::NONE, $beta = Values::NONE, $nearNumber = Values::NONE, $nearLatLong = Values::NONE, $distance = Values::NONE, $inPostalCode = Values::NONE, $inRegion = Values::NONE, $inRateCenter = Values::NONE, $inLata = Values::NONE, $inLocality = Values::NONE, $faxEnabled = Values::NONE) {
         $this->options['areaCode'] = $areaCode;
@@ -86,9 +120,9 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The area_code
+     * Find phone numbers in the specified area code. (US and Canada only)
      * 
-     * @param integer $areaCode The area_code
+     * @param integer $areaCode Find phone numbers in the specified area code.
      * @return $this Fluent Builder
      */
     public function setAreaCode($areaCode) {
@@ -97,9 +131,9 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The contains
+     * A pattern on which to match phone numbers. Valid characters are `'*'` and `[0-9a-zA-Z]`. The `'*'` character will match any single digit. See [Example 2](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-3) below. *NOTE:* Patterns must be at least two characters long.
      * 
-     * @param string $contains The contains
+     * @param string $contains A pattern on which to match phone numbers.
      * @return $this Fluent Builder
      */
     public function setContains($contains) {
@@ -108,9 +142,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The sms_enabled
+     * This indicates whether the phone numbers can receive text messages. Possible values are `true` or `false`.
      * 
-     * @param boolean $smsEnabled The sms_enabled
+     * @param boolean $smsEnabled This indicates whether the phone numbers can
+     *                            receive text messages.
      * @return $this Fluent Builder
      */
     public function setSmsEnabled($smsEnabled) {
@@ -119,9 +154,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The mms_enabled
+     * This indicates whether the phone numbers can receive MMS messages. Possible values are `true` or `false`.
      * 
-     * @param boolean $mmsEnabled The mms_enabled
+     * @param boolean $mmsEnabled This indicates whether the phone numbers can
+     *                            receive MMS messages.
      * @return $this Fluent Builder
      */
     public function setMmsEnabled($mmsEnabled) {
@@ -130,9 +166,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The voice_enabled
+     * This indicates whether the phone numbers can receive calls. Possible values are `true` or `false`.
      * 
-     * @param boolean $voiceEnabled The voice_enabled
+     * @param boolean $voiceEnabled This indicates whether the phone numbers can
+     *                              receive calls.
      * @return $this Fluent Builder
      */
     public function setVoiceEnabled($voiceEnabled) {
@@ -141,9 +178,11 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The exclude_all_address_required
+     * Indicates whether the response includes phone numbers which require any [Address](https://www.twilio.com/docs/usage/api/addresses). Possible values are `true` or `false`. If not specified, the default is `false`, and results could include phone numbers with an Address required.
      * 
-     * @param boolean $excludeAllAddressRequired The exclude_all_address_required
+     * @param boolean $excludeAllAddressRequired Indicates whether the response
+     *                                           includes phone numbers which
+     *                                           require any Address.
      * @return $this Fluent Builder
      */
     public function setExcludeAllAddressRequired($excludeAllAddressRequired) {
@@ -152,10 +191,11 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The exclude_local_address_required
+     * Indicates whether the response includes phone numbers which require a local [Address](https://www.twilio.com/docs/usage/api/addresses). Possible values are `true` or `false`. If not specified, the default is `false`, and results could include phone numbers with a local Address required.
      * 
-     * @param boolean $excludeLocalAddressRequired The
-     *                                             exclude_local_address_required
+     * @param boolean $excludeLocalAddressRequired Indicates whether the response
+     *                                             includes phone numbers which
+     *                                             require a local Address.
      * @return $this Fluent Builder
      */
     public function setExcludeLocalAddressRequired($excludeLocalAddressRequired) {
@@ -164,10 +204,11 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The exclude_foreign_address_required
+     * Indicates whether the response includes phone numbers which require a foreign [Address](https://www.twilio.com/docs/usage/api/addresses). Possible values are `true` or `false`. If not specified, the default is `false`, and results could include phone numbers with a foreign Address required.
      * 
-     * @param boolean $excludeForeignAddressRequired The
-     *                                               exclude_foreign_address_required
+     * @param boolean $excludeForeignAddressRequired Indicates whether the response
+     *                                               includes phone numbers which
+     *                                               require a foreign Address.
      * @return $this Fluent Builder
      */
     public function setExcludeForeignAddressRequired($excludeForeignAddressRequired) {
@@ -176,9 +217,9 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The beta
+     * Include phone numbers new to the Twilio platform. Possible values are either `true` or `false`. Default is `true`.
      * 
-     * @param boolean $beta The beta
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
      * @return $this Fluent Builder
      */
     public function setBeta($beta) {
@@ -187,9 +228,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The near_number
+     * Given a phone number, find a geographically close number within `Distance` miles. Distance defaults to 25 miles. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $nearNumber The near_number
+     * @param string $nearNumber Given a phone number, find a geographically close
+     *                           number within Distance miles. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setNearNumber($nearNumber) {
@@ -198,9 +240,11 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The near_lat_long
+     * Given a latitude/longitude pair `lat,long` find geographically close numbers within `Distance` miles. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $nearLatLong The near_lat_long
+     * @param string $nearLatLong Given a latitude/longitude pair lat,long find
+     *                            geographically close numbers within Distance
+     *                            miles. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setNearLatLong($nearLatLong) {
@@ -209,9 +253,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The distance
+     * Specifies the search radius for a `Near-` query in miles. If not specified this defaults to 25 miles. Maximum searchable distance is 500 miles. *Limited to US and Canadian phone numbers.*
      * 
-     * @param integer $distance The distance
+     * @param integer $distance Specifies the search radius for a Near- query in
+     *                          miles. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setDistance($distance) {
@@ -220,9 +265,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The in_postal_code
+     * Limit results to a particular postal code. Given a phone number, search within the same postal code as that number. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inPostalCode The in_postal_code
+     * @param string $inPostalCode Limit results to a particular postal code.
+     *                             (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setInPostalCode($inPostalCode) {
@@ -231,9 +277,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The in_region
+     * Limit results to a particular region (i.e. State/Province). Given a phone number, search within the same Region as that number. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inRegion The in_region
+     * @param string $inRegion Limit results to a particular region. (US/Canada
+     *                         only)
      * @return $this Fluent Builder
      */
     public function setInRegion($inRegion) {
@@ -242,9 +289,11 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The in_rate_center
+     * Limit results to a specific rate center, or given a phone number search within the same rate center as that number. Requires InLata to be set as well. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inRateCenter The in_rate_center
+     * @param string $inRateCenter Limit results to a specific rate center, or
+     *                             given a phone number search within the same rate
+     *                             center as that number. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setInRateCenter($inRateCenter) {
@@ -253,9 +302,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The in_lata
+     * Limit results to a specific Local access and transport area ([LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area)). Given a phone number, search within the same [LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area) as that number. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inLata The in_lata
+     * @param string $inLata Limit results to a specific Local access and transport
+     *                       area. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setInLata($inLata) {
@@ -264,9 +314,9 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The in_locality
+     * Limit results to a particular locality (i.e.  City). Given a phone number, search within the same Locality as that number.
      * 
-     * @param string $inLocality The in_locality
+     * @param string $inLocality Limit results to a particular locality.
      * @return $this Fluent Builder
      */
     public function setInLocality($inLocality) {
@@ -275,9 +325,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The fax_enabled
+     * This indicates whether the phone numbers can receive faxes. Possible values are `true` or `false`.
      * 
-     * @param boolean $faxEnabled The fax_enabled
+     * @param boolean $faxEnabled This indicates whether the phone numbers can
+     *                            receive faxes.
      * @return $this Fluent Builder
      */
     public function setFaxEnabled($faxEnabled) {

plugins/Twilio/Rest/Api/V2010/Account/AvailablePhoneNumberCountry/MobilePage.php

@@ -14,26 +14,43 @@ use Twilio\Values;
 
 abstract class TollFreeOptions {
     /**
-     * @param integer $areaCode The area_code
-     * @param string $contains The contains
-     * @param boolean $smsEnabled The sms_enabled
-     * @param boolean $mmsEnabled The mms_enabled
-     * @param boolean $voiceEnabled The voice_enabled
-     * @param boolean $excludeAllAddressRequired The exclude_all_address_required
-     * @param boolean $excludeLocalAddressRequired The
-     *                                             exclude_local_address_required
-     * @param boolean $excludeForeignAddressRequired The
-     *                                               exclude_foreign_address_required
-     * @param boolean $beta The beta
-     * @param string $nearNumber The near_number
-     * @param string $nearLatLong The near_lat_long
-     * @param integer $distance The distance
-     * @param string $inPostalCode The in_postal_code
-     * @param string $inRegion The in_region
-     * @param string $inRateCenter The in_rate_center
-     * @param string $inLata The in_lata
-     * @param string $inLocality The in_locality
-     * @param boolean $faxEnabled The fax_enabled
+     * @param integer $areaCode Find phone numbers in the specified area code.
+     * @param string $contains A pattern on which to match phone numbers.
+     * @param boolean $smsEnabled This indicates whether the phone numbers can
+     *                            receive text messages.
+     * @param boolean $mmsEnabled This indicates whether the phone numbers can
+     *                            receive MMS messages.
+     * @param boolean $voiceEnabled This indicates whether the phone numbers can
+     *                              receive calls.
+     * @param boolean $excludeAllAddressRequired Indicates whether the response
+     *                                           includes phone numbers which
+     *                                           require any Address.
+     * @param boolean $excludeLocalAddressRequired Indicates whether the response
+     *                                             includes phone numbers which
+     *                                             require a local Address.
+     * @param boolean $excludeForeignAddressRequired Indicates whether the response
+     *                                               includes phone numbers which
+     *                                               require a foreign Address.
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $nearNumber Given a phone number, find a geographically close
+     *                           number within Distance miles. (US/Canada only)
+     * @param string $nearLatLong Given a latitude/longitude pair lat,long find
+     *                            geographically close numbers within Distance
+     *                            miles. (US/Canada only)
+     * @param integer $distance Specifies the search radius for a Near- query in
+     *                          miles. (US/Canada only)
+     * @param string $inPostalCode Limit results to a particular postal code.
+     *                             (US/Canada only)
+     * @param string $inRegion Limit results to a particular region. (US/Canada
+     *                         only)
+     * @param string $inRateCenter Limit results to a specific rate center, or
+     *                             given a phone number search within the same rate
+     *                             center as that number. (US/Canada only)
+     * @param string $inLata Limit results to a specific Local access and transport
+     *                       area. (US/Canada only)
+     * @param string $inLocality Limit results to a particular locality.
+     * @param boolean $faxEnabled This indicates whether the phone numbers can
+     *                            receive faxes.
      * @return ReadTollFreeOptions Options builder
      */
     public static function read($areaCode = Values::NONE, $contains = Values::NONE, $smsEnabled = Values::NONE, $mmsEnabled = Values::NONE, $voiceEnabled = Values::NONE, $excludeAllAddressRequired = Values::NONE, $excludeLocalAddressRequired = Values::NONE, $excludeForeignAddressRequired = Values::NONE, $beta = Values::NONE, $nearNumber = Values::NONE, $nearLatLong = Values::NONE, $distance = Values::NONE, $inPostalCode = Values::NONE, $inRegion = Values::NONE, $inRateCenter = Values::NONE, $inLata = Values::NONE, $inLocality = Values::NONE, $faxEnabled = Values::NONE) {
@@ -43,26 +60,43 @@ abstract class TollFreeOptions {
 
 class ReadTollFreeOptions extends Options {
     /**
-     * @param integer $areaCode The area_code
-     * @param string $contains The contains
-     * @param boolean $smsEnabled The sms_enabled
-     * @param boolean $mmsEnabled The mms_enabled
-     * @param boolean $voiceEnabled The voice_enabled
-     * @param boolean $excludeAllAddressRequired The exclude_all_address_required
-     * @param boolean $excludeLocalAddressRequired The
-     *                                             exclude_local_address_required
-     * @param boolean $excludeForeignAddressRequired The
-     *                                               exclude_foreign_address_required
-     * @param boolean $beta The beta
-     * @param string $nearNumber The near_number
-     * @param string $nearLatLong The near_lat_long
-     * @param integer $distance The distance
-     * @param string $inPostalCode The in_postal_code
-     * @param string $inRegion The in_region
-     * @param string $inRateCenter The in_rate_center
-     * @param string $inLata The in_lata
-     * @param string $inLocality The in_locality
-     * @param boolean $faxEnabled The fax_enabled
+     * @param integer $areaCode Find phone numbers in the specified area code.
+     * @param string $contains A pattern on which to match phone numbers.
+     * @param boolean $smsEnabled This indicates whether the phone numbers can
+     *                            receive text messages.
+     * @param boolean $mmsEnabled This indicates whether the phone numbers can
+     *                            receive MMS messages.
+     * @param boolean $voiceEnabled This indicates whether the phone numbers can
+     *                              receive calls.
+     * @param boolean $excludeAllAddressRequired Indicates whether the response
+     *                                           includes phone numbers which
+     *                                           require any Address.
+     * @param boolean $excludeLocalAddressRequired Indicates whether the response
+     *                                             includes phone numbers which
+     *                                             require a local Address.
+     * @param boolean $excludeForeignAddressRequired Indicates whether the response
+     *                                               includes phone numbers which
+     *                                               require a foreign Address.
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $nearNumber Given a phone number, find a geographically close
+     *                           number within Distance miles. (US/Canada only)
+     * @param string $nearLatLong Given a latitude/longitude pair lat,long find
+     *                            geographically close numbers within Distance
+     *                            miles. (US/Canada only)
+     * @param integer $distance Specifies the search radius for a Near- query in
+     *                          miles. (US/Canada only)
+     * @param string $inPostalCode Limit results to a particular postal code.
+     *                             (US/Canada only)
+     * @param string $inRegion Limit results to a particular region. (US/Canada
+     *                         only)
+     * @param string $inRateCenter Limit results to a specific rate center, or
+     *                             given a phone number search within the same rate
+     *                             center as that number. (US/Canada only)
+     * @param string $inLata Limit results to a specific Local access and transport
+     *                       area. (US/Canada only)
+     * @param string $inLocality Limit results to a particular locality.
+     * @param boolean $faxEnabled This indicates whether the phone numbers can
+     *                            receive faxes.
      */
     public function __construct($areaCode = Values::NONE, $contains = Values::NONE, $smsEnabled = Values::NONE, $mmsEnabled = Values::NONE, $voiceEnabled = Values::NONE, $excludeAllAddressRequired = Values::NONE, $excludeLocalAddressRequired = Values::NONE, $excludeForeignAddressRequired = Values::NONE, $beta = Values::NONE, $nearNumber = Values::NONE, $nearLatLong = Values::NONE, $distance = Values::NONE, $inPostalCode = Values::NONE, $inRegion = Values::NONE, $inRateCenter = Values::NONE, $inLata = Values::NONE, $inLocality = Values::NONE, $faxEnabled = Values::NONE) {
         $this->options['areaCode'] = $areaCode;
@@ -86,9 +120,9 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The area_code
+     * Find phone numbers in the specified area code. (US and Canada only)
      * 
-     * @param integer $areaCode The area_code
+     * @param integer $areaCode Find phone numbers in the specified area code.
      * @return $this Fluent Builder
      */
     public function setAreaCode($areaCode) {
@@ -97,9 +131,9 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The contains
+     * A pattern on which to match phone numbers. Valid characters are `'*'` and `[0-9a-zA-Z]`. The `'*'` character will match any single digit. See [Example 2](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-3) below. *NOTE:* Patterns must be at least two characters long.
      * 
-     * @param string $contains The contains
+     * @param string $contains A pattern on which to match phone numbers.
      * @return $this Fluent Builder
      */
     public function setContains($contains) {
@@ -108,9 +142,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The sms_enabled
+     * This indicates whether the phone numbers can receive text messages. Possible values are `true` or `false`.
      * 
-     * @param boolean $smsEnabled The sms_enabled
+     * @param boolean $smsEnabled This indicates whether the phone numbers can
+     *                            receive text messages.
      * @return $this Fluent Builder
      */
     public function setSmsEnabled($smsEnabled) {
@@ -119,9 +154,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The mms_enabled
+     * This indicates whether the phone numbers can receive MMS messages. Possible values are `true` or `false`.
      * 
-     * @param boolean $mmsEnabled The mms_enabled
+     * @param boolean $mmsEnabled This indicates whether the phone numbers can
+     *                            receive MMS messages.
      * @return $this Fluent Builder
      */
     public function setMmsEnabled($mmsEnabled) {
@@ -130,9 +166,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The voice_enabled
+     * This indicates whether the phone numbers can receive calls. Possible values are `true` or `false`.
      * 
-     * @param boolean $voiceEnabled The voice_enabled
+     * @param boolean $voiceEnabled This indicates whether the phone numbers can
+     *                              receive calls.
      * @return $this Fluent Builder
      */
     public function setVoiceEnabled($voiceEnabled) {
@@ -141,9 +178,11 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The exclude_all_address_required
+     * Indicates whether the response includes phone numbers which require any [Address](https://www.twilio.com/docs/usage/api/addresses). Possible values are `true` or `false`. If not specified, the default is `false`, and results could include phone numbers with an Address required.
      * 
-     * @param boolean $excludeAllAddressRequired The exclude_all_address_required
+     * @param boolean $excludeAllAddressRequired Indicates whether the response
+     *                                           includes phone numbers which
+     *                                           require any Address.
      * @return $this Fluent Builder
      */
     public function setExcludeAllAddressRequired($excludeAllAddressRequired) {
@@ -152,10 +191,11 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The exclude_local_address_required
+     * Indicates whether the response includes phone numbers which require a local [Address](https://www.twilio.com/docs/usage/api/addresses). Possible values are `true` or `false`. If not specified, the default is `false`, and results could include phone numbers with a local Address required.
      * 
-     * @param boolean $excludeLocalAddressRequired The
-     *                                             exclude_local_address_required
+     * @param boolean $excludeLocalAddressRequired Indicates whether the response
+     *                                             includes phone numbers which
+     *                                             require a local Address.
      * @return $this Fluent Builder
      */
     public function setExcludeLocalAddressRequired($excludeLocalAddressRequired) {
@@ -164,10 +204,11 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The exclude_foreign_address_required
+     * Indicates whether the response includes phone numbers which require a foreign [Address](https://www.twilio.com/docs/usage/api/addresses). Possible values are `true` or `false`. If not specified, the default is `false`, and results could include phone numbers with a foreign Address required.
      * 
-     * @param boolean $excludeForeignAddressRequired The
-     *                                               exclude_foreign_address_required
+     * @param boolean $excludeForeignAddressRequired Indicates whether the response
+     *                                               includes phone numbers which
+     *                                               require a foreign Address.
      * @return $this Fluent Builder
      */
     public function setExcludeForeignAddressRequired($excludeForeignAddressRequired) {
@@ -176,9 +217,9 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The beta
+     * Include phone numbers new to the Twilio platform. Possible values are either `true` or `false`. Default is `true`.
      * 
-     * @param boolean $beta The beta
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
      * @return $this Fluent Builder
      */
     public function setBeta($beta) {
@@ -187,9 +228,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The near_number
+     * Given a phone number, find a geographically close number within `Distance` miles. Distance defaults to 25 miles. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $nearNumber The near_number
+     * @param string $nearNumber Given a phone number, find a geographically close
+     *                           number within Distance miles. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setNearNumber($nearNumber) {
@@ -198,9 +240,11 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The near_lat_long
+     * Given a latitude/longitude pair `lat,long` find geographically close numbers within `Distance` miles. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $nearLatLong The near_lat_long
+     * @param string $nearLatLong Given a latitude/longitude pair lat,long find
+     *                            geographically close numbers within Distance
+     *                            miles. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setNearLatLong($nearLatLong) {
@@ -209,9 +253,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The distance
+     * Specifies the search radius for a `Near-` query in miles. If not specified this defaults to 25 miles. Maximum searchable distance is 500 miles. *Limited to US and Canadian phone numbers.*
      * 
-     * @param integer $distance The distance
+     * @param integer $distance Specifies the search radius for a Near- query in
+     *                          miles. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setDistance($distance) {
@@ -220,9 +265,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The in_postal_code
+     * Limit results to a particular postal code. Given a phone number, search within the same postal code as that number. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inPostalCode The in_postal_code
+     * @param string $inPostalCode Limit results to a particular postal code.
+     *                             (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setInPostalCode($inPostalCode) {
@@ -231,9 +277,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The in_region
+     * Limit results to a particular region (i.e.  State/Province). Given a phone number, search within the same Region as that number. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inRegion The in_region
+     * @param string $inRegion Limit results to a particular region. (US/Canada
+     *                         only)
      * @return $this Fluent Builder
      */
     public function setInRegion($inRegion) {
@@ -242,9 +289,11 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The in_rate_center
+     * Limit results to a specific rate center, or given a phone number search within the same rate center as that number. Requires InLata to be set as well. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inRateCenter The in_rate_center
+     * @param string $inRateCenter Limit results to a specific rate center, or
+     *                             given a phone number search within the same rate
+     *                             center as that number. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setInRateCenter($inRateCenter) {
@@ -253,9 +302,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The in_lata
+     * Limit results to a specific Local access and transport area ([LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area)). Given a phone number, search within the same [LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area) as that number. *Limited to US and Canadian phone numbers.*
      * 
-     * @param string $inLata The in_lata
+     * @param string $inLata Limit results to a specific Local access and transport
+     *                       area. (US/Canada only)
      * @return $this Fluent Builder
      */
     public function setInLata($inLata) {
@@ -264,9 +314,9 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The in_locality
+     * Limit results to a particular locality (i.e.  City). Given a phone number, search within the same Locality as that number.
      * 
-     * @param string $inLocality The in_locality
+     * @param string $inLocality Limit results to a particular locality.
      * @return $this Fluent Builder
      */
     public function setInLocality($inLocality) {
@@ -275,9 +325,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The fax_enabled
+     * This indicates whether the phone numbers can receive faxes. Possible values are `true` or `false`.
      * 
-     * @param boolean $faxEnabled The fax_enabled
+     * @param boolean $faxEnabled This indicates whether the phone numbers can
+     *                            receive faxes.
      * @return $this Fluent Builder
      */
     public function setFaxEnabled($faxEnabled) {

plugins/Twilio/Rest/Api/V2010/Account/AvailablePhoneNumberCountry/TollFreePage.php

@@ -61,6 +61,7 @@ class AvailablePhoneNumberCountryContext extends InstanceContext {
      * 
      * @return AvailablePhoneNumberCountryInstance Fetched
      *                                             AvailablePhoneNumberCountryInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());

plugins/Twilio/Rest/Api/V2010/Account/AvailablePhoneNumberCountryInstance.php

@@ -81,6 +81,7 @@ class AvailablePhoneNumberCountryInstance extends InstanceResource {
      * 
      * @return AvailablePhoneNumberCountryInstance Fetched
      *                                             AvailablePhoneNumberCountryInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();

plugins/Twilio/Rest/Api/V2010/Account/AvailablePhoneNumberCountryList.php

@@ -36,9 +36,10 @@ class FeedbackContext extends InstanceContext {
     /**
      * Create a new FeedbackInstance
      * 
-     * @param integer $qualityScore The quality_score
+     * @param integer $qualityScore An integer from 1 to 5
      * @param array|Options $options Optional Arguments
      * @return FeedbackInstance Newly created FeedbackInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($qualityScore, $options = array()) {
         $options = new Values($options);
@@ -67,6 +68,7 @@ class FeedbackContext extends InstanceContext {
      * Fetch a FeedbackInstance
      * 
      * @return FeedbackInstance Fetched FeedbackInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -91,6 +93,7 @@ class FeedbackContext extends InstanceContext {
      * @param integer $qualityScore An integer from 1 to 5
      * @param array|Options $options Optional Arguments
      * @return FeedbackInstance Updated FeedbackInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($qualityScore, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/Call/FeedbackInstance.php

@@ -31,8 +31,8 @@ class FeedbackInstance extends InstanceResource {
      * @param \Twilio\Version $version Version that contains the resource
      * @param mixed[] $payload The response payload
      * @param string $accountSid The account_sid
-     * @param string $callSid A 34 character string that uniquely identifies this
-     *                        resource.
+     * @param string $callSid A 34-character string that uniquely identifies the
+     *                        Call resource.
      * @return \Twilio\Rest\Api\V2010\Account\Call\FeedbackInstance 
      */
     public function __construct(Version $version, array $payload, $accountSid, $callSid) {
@@ -73,9 +73,10 @@ class FeedbackInstance extends InstanceResource {
     /**
      * Create a new FeedbackInstance
      * 
-     * @param integer $qualityScore The quality_score
+     * @param integer $qualityScore An integer from 1 to 5
      * @param array|Options $options Optional Arguments
      * @return FeedbackInstance Newly created FeedbackInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($qualityScore, $options = array()) {
         return $this->proxy()->create($qualityScore, $options);
@@ -85,6 +86,7 @@ class FeedbackInstance extends InstanceResource {
      * Fetch a FeedbackInstance
      * 
      * @return FeedbackInstance Fetched FeedbackInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -96,6 +98,7 @@ class FeedbackInstance extends InstanceResource {
      * @param integer $qualityScore An integer from 1 to 5
      * @param array|Options $options Optional Arguments
      * @return FeedbackInstance Updated FeedbackInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($qualityScore, $options = array()) {
         return $this->proxy()->update($qualityScore, $options);

plugins/Twilio/Rest/Api/V2010/Account/Call/FeedbackList.php

@@ -18,8 +18,8 @@ class FeedbackList extends ListResource {
      * 
      * @param Version $version Version that contains the resource
      * @param string $accountSid The account_sid
-     * @param string $callSid A 34 character string that uniquely identifies this
-     *                        resource.
+     * @param string $callSid A 34-character string that uniquely identifies the
+     *                        Call resource.
      * @return \Twilio\Rest\Api\V2010\Account\Call\FeedbackList 
      */
     public function __construct(Version $version, $accountSid, $callSid) {

plugins/Twilio/Rest/Api/V2010/Account/Call/FeedbackOptions.php

@@ -14,7 +14,7 @@ use Twilio\Values;
 
 abstract class FeedbackOptions {
     /**
-     * @param string $issue The issue
+     * @param string $issue Issues experienced during the call
      * @return CreateFeedbackOptions Options builder
      */
     public static function create($issue = Values::NONE) {
@@ -32,16 +32,16 @@ abstract class FeedbackOptions {
 
 class CreateFeedbackOptions extends Options {
     /**
-     * @param string $issue The issue
+     * @param string $issue Issues experienced during the call
      */
     public function __construct($issue = Values::NONE) {
         $this->options['issue'] = $issue;
     }
 
     /**
-     * The issue
+     * One or more issues experienced during the call. The issues can be: `imperfect-audio`, `dropped-call`, `incorrect-caller-id`, `post-dial-delay`, `digits-not-captured`, `audio-latency`, or `one-way-audio`.
      * 
-     * @param string $issue The issue
+     * @param string $issue Issues experienced during the call
      * @return $this Fluent Builder
      */
     public function setIssue($issue) {
@@ -74,7 +74,7 @@ class UpdateFeedbackOptions extends Options {
     }
 
     /**
-     * One or more of the issues experienced during the call
+     * One or more issues experienced during the call. The issues can be: `imperfect-audio`, `dropped-call`, `incorrect-caller-id`, `post-dial-delay`, `digits-not-captured`, `audio-latency`, or `one-way-audio`.
      * 
      * @param string $issue Issues experienced during the call
      * @return $this Fluent Builder

plugins/Twilio/Rest/Api/V2010/Account/Call/FeedbackPage.php

@@ -35,6 +35,7 @@ class FeedbackSummaryContext extends InstanceContext {
      * Fetch a FeedbackSummaryInstance
      * 
      * @return FeedbackSummaryInstance Fetched FeedbackSummaryInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -57,6 +58,7 @@ class FeedbackSummaryContext extends InstanceContext {
      * Deletes the FeedbackSummaryInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/Call/FeedbackSummaryInstance.php

@@ -90,6 +90,7 @@ class FeedbackSummaryInstance extends InstanceResource {
      * Fetch a FeedbackSummaryInstance
      * 
      * @return FeedbackSummaryInstance Fetched FeedbackSummaryInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -99,6 +100,7 @@ class FeedbackSummaryInstance extends InstanceResource {
      * Deletes the FeedbackSummaryInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/Call/FeedbackSummaryList.php

@@ -36,10 +36,13 @@ class FeedbackSummaryList extends ListResource {
     /**
      * Create a new FeedbackSummaryInstance
      * 
-     * @param \DateTime $startDate The start_date
-     * @param \DateTime $endDate The end_date
+     * @param \DateTime $startDate Only include usage that has occurred on or after
+     *                             this date.
+     * @param \DateTime $endDate Only include usage that has occurred on or before
+     *                           this date.
      * @param array|Options $options Optional Arguments
      * @return FeedbackSummaryInstance Newly created FeedbackSummaryInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($startDate, $endDate, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/Call/FeedbackSummaryOptions.php

@@ -14,9 +14,12 @@ use Twilio\Values;
 
 abstract class FeedbackSummaryOptions {
     /**
-     * @param boolean $includeSubaccounts The include_subaccounts
-     * @param string $statusCallback The status_callback
-     * @param string $statusCallbackMethod The status_callback_method
+     * @param boolean $includeSubaccounts true to include feedback entries for the
+     *                                    master account and all subaccounts.
+     * @param string $statusCallback The URL that Twilio will request when the
+     *                               Feedback Summary is completed.
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
      * @return CreateFeedbackSummaryOptions Options builder
      */
     public static function create($includeSubaccounts = Values::NONE, $statusCallback = Values::NONE, $statusCallbackMethod = Values::NONE) {
@@ -26,9 +29,12 @@ abstract class FeedbackSummaryOptions {
 
 class CreateFeedbackSummaryOptions extends Options {
     /**
-     * @param boolean $includeSubaccounts The include_subaccounts
-     * @param string $statusCallback The status_callback
-     * @param string $statusCallbackMethod The status_callback_method
+     * @param boolean $includeSubaccounts true to include feedback entries for the
+     *                                    master account and all subaccounts.
+     * @param string $statusCallback The URL that Twilio will request when the
+     *                               Feedback Summary is completed.
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
      */
     public function __construct($includeSubaccounts = Values::NONE, $statusCallback = Values::NONE, $statusCallbackMethod = Values::NONE) {
         $this->options['includeSubaccounts'] = $includeSubaccounts;
@@ -37,9 +43,10 @@ class CreateFeedbackSummaryOptions extends Options {
     }
 
     /**
-     * The include_subaccounts
+     * true to include feedback entries for the master account and all subaccounts. false to include feedback entries for the specified account. IncludeSubaccounts is false by default.
      * 
-     * @param boolean $includeSubaccounts The include_subaccounts
+     * @param boolean $includeSubaccounts true to include feedback entries for the
+     *                                    master account and all subaccounts.
      * @return $this Fluent Builder
      */
     public function setIncludeSubaccounts($includeSubaccounts) {
@@ -48,9 +55,10 @@ class CreateFeedbackSummaryOptions extends Options {
     }
 
     /**
-     * The status_callback
+     * The URL that Twilio will request when the Feedback Summary is completed.
      * 
-     * @param string $statusCallback The status_callback
+     * @param string $statusCallback The URL that Twilio will request when the
+     *                               Feedback Summary is completed.
      * @return $this Fluent Builder
      */
     public function setStatusCallback($statusCallback) {
@@ -59,9 +67,10 @@ class CreateFeedbackSummaryOptions extends Options {
     }
 
     /**
-     * The status_callback_method
+     * The HTTP method Twilio will use to make requests to the StatusCallback URL. Either GET or POST.
      * 
-     * @param string $statusCallbackMethod The status_callback_method
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
      * @return $this Fluent Builder
      */
     public function setStatusCallbackMethod($statusCallbackMethod) {

plugins/Twilio/Rest/Api/V2010/Account/Call/FeedbackSummaryPage.php

@@ -36,6 +36,7 @@ class NotificationContext extends InstanceContext {
      * Fetch a NotificationInstance
      * 
      * @return NotificationInstance Fetched NotificationInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -59,6 +60,7 @@ class NotificationContext extends InstanceContext {
      * Deletes the NotificationInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/Call/NotificationInstance.php

@@ -101,6 +101,7 @@ class NotificationInstance extends InstanceResource {
      * Fetch a NotificationInstance
      * 
      * @return NotificationInstance Fetched NotificationInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -110,6 +111,7 @@ class NotificationInstance extends InstanceResource {
      * Deletes the NotificationInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/Call/NotificationList.php

@@ -19,8 +19,8 @@ class RecordingContext extends InstanceContext {
      * 
      * @param \Twilio\Version $version Version that contains the resource
      * @param string $accountSid The account_sid
-     * @param string $callSid The call_sid
-     * @param string $sid The sid
+     * @param string $callSid Fetch by unique call Sid for the recording
+     * @param string $sid Fetch by unique recording Sid
      * @return \Twilio\Rest\Api\V2010\Account\Call\RecordingContext 
      */
     public function __construct(Version $version, $accountSid, $callSid, $sid) {
@@ -32,10 +32,37 @@ class RecordingContext extends InstanceContext {
         $this->uri = '/Accounts/' . rawurlencode($accountSid) . '/Calls/' . rawurlencode($callSid) . '/Recordings/' . rawurlencode($sid) . '.json';
     }
 
+    /**
+     * Update the RecordingInstance
+     * 
+     * @param string $status The status to change the recording to.
+     * @return RecordingInstance Updated RecordingInstance
+     * @throws TwilioException When an HTTP error occurs.
+     */
+    public function update($status) {
+        $data = Values::of(array('Status' => $status, ));
+
+        $payload = $this->version->update(
+            'POST',
+            $this->uri,
+            array(),
+            $data
+        );
+
+        return new RecordingInstance(
+            $this->version,
+            $payload,
+            $this->solution['accountSid'],
+            $this->solution['callSid'],
+            $this->solution['sid']
+        );
+    }
+
     /**
      * Fetch a RecordingInstance
      * 
      * @return RecordingInstance Fetched RecordingInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -59,6 +86,7 @@ class RecordingContext extends InstanceContext {
      * Deletes the RecordingInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/Call/RecordingInstance.php

@@ -22,6 +22,7 @@ use Twilio\Version;
  * @property string conferenceSid
  * @property \DateTime dateCreated
  * @property \DateTime dateUpdated
+ * @property \DateTime startTime
  * @property string duration
  * @property string sid
  * @property string price
@@ -39,9 +40,10 @@ class RecordingInstance extends InstanceResource {
      * 
      * @param \Twilio\Version $version Version that contains the resource
      * @param mixed[] $payload The response payload
-     * @param string $accountSid The account_sid
-     * @param string $callSid The call_sid
-     * @param string $sid The sid
+     * @param string $accountSid The unique sid that identifies this account
+     * @param string $callSid The unique id for the call leg that corresponds to
+     *                        the recording.
+     * @param string $sid Fetch by unique recording Sid
      * @return \Twilio\Rest\Api\V2010\Account\Call\RecordingInstance 
      */
     public function __construct(Version $version, array $payload, $accountSid, $callSid, $sid = null) {
@@ -55,6 +57,7 @@ class RecordingInstance extends InstanceResource {
             'conferenceSid' => Values::array_get($payload, 'conference_sid'),
             'dateCreated' => Deserialize::dateTime(Values::array_get($payload, 'date_created')),
             'dateUpdated' => Deserialize::dateTime(Values::array_get($payload, 'date_updated')),
+            'startTime' => Deserialize::dateTime(Values::array_get($payload, 'start_time')),
             'duration' => Values::array_get($payload, 'duration'),
             'sid' => Values::array_get($payload, 'sid'),
             'price' => Values::array_get($payload, 'price'),
@@ -95,10 +98,22 @@ class RecordingInstance extends InstanceResource {
         return $this->context;
     }
 
+    /**
+     * Update the RecordingInstance
+     * 
+     * @param string $status The status to change the recording to.
+     * @return RecordingInstance Updated RecordingInstance
+     * @throws TwilioException When an HTTP error occurs.
+     */
+    public function update($status) {
+        return $this->proxy()->update($status);
+    }
+
     /**
      * Fetch a RecordingInstance
      * 
      * @return RecordingInstance Fetched RecordingInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -108,6 +123,7 @@ class RecordingInstance extends InstanceResource {
      * Deletes the RecordingInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/Call/RecordingList.php

@@ -20,8 +20,9 @@ class RecordingList extends ListResource {
      * Construct the RecordingList
      * 
      * @param Version $version Version that contains the resource
-     * @param string $accountSid The account_sid
-     * @param string $callSid The call_sid
+     * @param string $accountSid The unique sid that identifies this account
+     * @param string $callSid The unique id for the call leg that corresponds to
+     *                        the recording.
      * @return \Twilio\Rest\Api\V2010\Account\Call\RecordingList 
      */
     public function __construct(Version $version, $accountSid, $callSid) {
@@ -33,6 +34,40 @@ class RecordingList extends ListResource {
         $this->uri = '/Accounts/' . rawurlencode($accountSid) . '/Calls/' . rawurlencode($callSid) . '/Recordings.json';
     }
 
+    /**
+     * Create a new RecordingInstance
+     * 
+     * @param array|Options $options Optional Arguments
+     * @return RecordingInstance Newly created RecordingInstance
+     * @throws TwilioException When an HTTP error occurs.
+     */
+    public function create($options = array()) {
+        $options = new Values($options);
+
+        $data = Values::of(array(
+            'RecordingStatusCallbackEvent' => Serialize::map($options['recordingStatusCallbackEvent'], function($e) { return $e; }),
+            'RecordingStatusCallback' => $options['recordingStatusCallback'],
+            'RecordingStatusCallbackMethod' => $options['recordingStatusCallbackMethod'],
+            'Trim' => $options['trim'],
+            'RecordingChannels' => $options['recordingChannels'],
+            'PlayBeep' => Serialize::booleanToString($options['playBeep']),
+        ));
+
+        $payload = $this->version->create(
+            'POST',
+            $this->uri,
+            array(),
+            $data
+        );
+
+        return new RecordingInstance(
+            $this->version,
+            $payload,
+            $this->solution['accountSid'],
+            $this->solution['callSid']
+        );
+    }
+
     /**
      * Streams RecordingInstance records from the API as a generator stream.
      * This operation lazily loads records as efficiently as possible until the
@@ -129,7 +164,7 @@ class RecordingList extends ListResource {
     /**
      * Constructs a RecordingContext
      * 
-     * @param string $sid The sid
+     * @param string $sid Fetch by unique recording Sid
      * @return \Twilio\Rest\Api\V2010\Account\Call\RecordingContext 
      */
     public function getContext($sid) {

plugins/Twilio/Rest/Api/V2010/Account/Call/RecordingOptions.php

@@ -14,9 +14,24 @@ use Twilio\Values;
 
 abstract class RecordingOptions {
     /**
-     * @param string $dateCreatedBefore The date_created
-     * @param string $dateCreated The date_created
-     * @param string $dateCreatedAfter The date_created
+     * @param string $recordingStatusCallbackEvent The
+     *                                             recording_status_callback_event
+     * @param string $recordingStatusCallback The recording_status_callback
+     * @param string $recordingStatusCallbackMethod The
+     *                                              recording_status_callback_method
+     * @param string $trim Whether to trim the silence in the recording
+     * @param string $recordingChannels The recording_channels
+     * @param boolean $playBeep Whether to play beeps for recording status changes
+     * @return CreateRecordingOptions Options builder
+     */
+    public static function create($recordingStatusCallbackEvent = Values::NONE, $recordingStatusCallback = Values::NONE, $recordingStatusCallbackMethod = Values::NONE, $trim = Values::NONE, $recordingChannels = Values::NONE, $playBeep = Values::NONE) {
+        return new CreateRecordingOptions($recordingStatusCallbackEvent, $recordingStatusCallback, $recordingStatusCallbackMethod, $trim, $recordingChannels, $playBeep);
+    }
+
+    /**
+     * @param string $dateCreatedBefore Filter by date created
+     * @param string $dateCreated Filter by date created
+     * @param string $dateCreatedAfter Filter by date created
      * @return ReadRecordingOptions Options builder
      */
     public static function read($dateCreatedBefore = Values::NONE, $dateCreated = Values::NONE, $dateCreatedAfter = Values::NONE) {
@@ -24,11 +39,115 @@ abstract class RecordingOptions {
     }
 }
 
+class CreateRecordingOptions extends Options {
+    /**
+     * @param string $recordingStatusCallbackEvent The
+     *                                             recording_status_callback_event
+     * @param string $recordingStatusCallback The recording_status_callback
+     * @param string $recordingStatusCallbackMethod The
+     *                                              recording_status_callback_method
+     * @param string $trim Whether to trim the silence in the recording
+     * @param string $recordingChannels The recording_channels
+     * @param boolean $playBeep Whether to play beeps for recording status changes
+     */
+    public function __construct($recordingStatusCallbackEvent = Values::NONE, $recordingStatusCallback = Values::NONE, $recordingStatusCallbackMethod = Values::NONE, $trim = Values::NONE, $recordingChannels = Values::NONE, $playBeep = Values::NONE) {
+        $this->options['recordingStatusCallbackEvent'] = $recordingStatusCallbackEvent;
+        $this->options['recordingStatusCallback'] = $recordingStatusCallback;
+        $this->options['recordingStatusCallbackMethod'] = $recordingStatusCallbackMethod;
+        $this->options['trim'] = $trim;
+        $this->options['recordingChannels'] = $recordingChannels;
+        $this->options['playBeep'] = $playBeep;
+    }
+
+    /**
+     * The recording_status_callback_event
+     * 
+     * @param string $recordingStatusCallbackEvent The
+     *                                             recording_status_callback_event
+     * @return $this Fluent Builder
+     */
+    public function setRecordingStatusCallbackEvent($recordingStatusCallbackEvent) {
+        $this->options['recordingStatusCallbackEvent'] = $recordingStatusCallbackEvent;
+        return $this;
+    }
+
+    /**
+     * The recording_status_callback
+     * 
+     * @param string $recordingStatusCallback The recording_status_callback
+     * @return $this Fluent Builder
+     */
+    public function setRecordingStatusCallback($recordingStatusCallback) {
+        $this->options['recordingStatusCallback'] = $recordingStatusCallback;
+        return $this;
+    }
+
+    /**
+     * The recording_status_callback_method
+     * 
+     * @param string $recordingStatusCallbackMethod The
+     *                                              recording_status_callback_method
+     * @return $this Fluent Builder
+     */
+    public function setRecordingStatusCallbackMethod($recordingStatusCallbackMethod) {
+        $this->options['recordingStatusCallbackMethod'] = $recordingStatusCallbackMethod;
+        return $this;
+    }
+
+    /**
+     * Possible values `trim-silence` or `do-not-trim`. `trim-silence` will trim the silence from the beginning and end of the recording. `do-not-trim` will not trim the silence. Defaults to `do-not-trim`
+     * 
+     * @param string $trim Whether to trim the silence in the recording
+     * @return $this Fluent Builder
+     */
+    public function setTrim($trim) {
+        $this->options['trim'] = $trim;
+        return $this;
+    }
+
+    /**
+     * The recording_channels
+     * 
+     * @param string $recordingChannels The recording_channels
+     * @return $this Fluent Builder
+     */
+    public function setRecordingChannels($recordingChannels) {
+        $this->options['recordingChannels'] = $recordingChannels;
+        return $this;
+    }
+
+    /**
+     * Possible values : true or false.  true will play a double beep before the recording is paused or stopped or a single beep after the recording is resumed. Defaults to false
+     * 
+     * @param boolean $playBeep Whether to play beeps for recording status changes
+     * @return $this Fluent Builder
+     */
+    public function setPlayBeep($playBeep) {
+        $this->options['playBeep'] = $playBeep;
+        return $this;
+    }
+
+    /**
+     * Provide a friendly representation
+     * 
+     * @return string Machine friendly representation
+     */
+    public function __toString() {
+        $options = array();
+        foreach ($this->options as $key => $value) {
+            if ($value != Values::NONE) {
+                $options[] = "$key=$value";
+            }
+        }
+        return '[Twilio.Api.V2010.CreateRecordingOptions ' . implode(' ', $options) . ']';
+    }
+}
+
 class ReadRecordingOptions extends Options {
     /**
-     * @param string $dateCreatedBefore The date_created
-     * @param string $dateCreated The date_created
-     * @param string $dateCreatedAfter The date_created
+     * @param string $dateCreatedBefore Filter by date created
+     * @param string $dateCreated Filter by date created
+     * @param string $dateCreatedAfter Filter by date created
      */
     public function __construct($dateCreatedBefore = Values::NONE, $dateCreated = Values::NONE, $dateCreatedAfter = Values::NONE) {
         $this->options['dateCreatedBefore'] = $dateCreatedBefore;
@@ -37,9 +156,9 @@ class ReadRecordingOptions extends Options {
     }
 
     /**
-     * The date_created
+     * Only show recordings created on the given date. Should be formatted as `YYYY-MM-DD`. You can also specify inequality, such as `DateCreated<=YYYY-MM-DD` for recordings generated at or before midnight on a date, and `DateCreated>=YYYY-MM-DD` for recordings generated at or after midnight on a date.
      * 
-     * @param string $dateCreatedBefore The date_created
+     * @param string $dateCreatedBefore Filter by date created
      * @return $this Fluent Builder
      */
     public function setDateCreatedBefore($dateCreatedBefore) {
@@ -48,9 +167,9 @@ class ReadRecordingOptions extends Options {
     }
 
     /**
-     * The date_created
+     * Only show recordings created on the given date. Should be formatted as `YYYY-MM-DD`. You can also specify inequality, such as `DateCreated<=YYYY-MM-DD` for recordings generated at or before midnight on a date, and `DateCreated>=YYYY-MM-DD` for recordings generated at or after midnight on a date.
      * 
-     * @param string $dateCreated The date_created
+     * @param string $dateCreated Filter by date created
      * @return $this Fluent Builder
      */
     public function setDateCreated($dateCreated) {
@@ -59,9 +178,9 @@ class ReadRecordingOptions extends Options {
     }
 
     /**
-     * The date_created
+     * Only show recordings created on the given date. Should be formatted as `YYYY-MM-DD`. You can also specify inequality, such as `DateCreated<=YYYY-MM-DD` for recordings generated at or before midnight on a date, and `DateCreated>=YYYY-MM-DD` for recordings generated at or after midnight on a date.
      * 
-     * @param string $dateCreatedAfter The date_created
+     * @param string $dateCreatedAfter Filter by date created
      * @return $this Fluent Builder
      */
     public function setDateCreatedAfter($dateCreatedAfter) {

plugins/Twilio/Rest/Api/V2010/Account/Call/RecordingPage.php

@@ -52,6 +52,7 @@ class CallContext extends InstanceContext {
      * Deletes the CallInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);
@@ -61,6 +62,7 @@ class CallContext extends InstanceContext {
      * Fetch a CallInstance
      * 
      * @return CallInstance Fetched CallInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -84,6 +86,7 @@ class CallContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return CallInstance Updated CallInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/CallInstance.php

@@ -116,6 +116,7 @@ class CallInstance extends InstanceResource {
      * Deletes the CallInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();
@@ -125,6 +126,7 @@ class CallInstance extends InstanceResource {
      * Fetch a CallInstance
      * 
      * @return CallInstance Fetched CallInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -135,6 +137,7 @@ class CallInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return CallInstance Updated CallInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);

plugins/Twilio/Rest/Api/V2010/Account/CallList.php

@@ -44,10 +44,11 @@ class CallList extends ListResource {
     /**
      * Create a new CallInstance
      * 
-     * @param string $to Phone number, SIP address or client identifier to call
+     * @param string $to Phone number, SIP address, or client identifier to call
      * @param string $from Twilio number from which to originate the call
      * @param array|Options $options Optional Arguments
      * @return CallInstance Newly created CallInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($to, $from, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/CallOptions.php

@@ -21,29 +21,37 @@ abstract class CallOptions {
      * @param string $fallbackUrl Fallback URL in case of error
      * @param string $fallbackMethod HTTP Method to use with FallbackUrl
      * @param string $statusCallback Status Callback URL
-     * @param string $statusCallbackEvent The status_callback_event
+     * @param string $statusCallbackEvent The call progress events that Twilio will
+     *                                    send webhooks on.
      * @param string $statusCallbackMethod HTTP Method to use with StatusCallback
      * @param string $sendDigits Digits to send
-     * @param string $ifMachine Action to take if a machine has answered the call
+     * @param string $ifMachine The if_machine
      * @param integer $timeout Number of seconds to wait for an answer
      * @param boolean $record Whether or not to record the Call
-     * @param string $recordingChannels The recording_channels
-     * @param string $recordingStatusCallback The recording_status_callback
-     * @param string $recordingStatusCallbackMethod The
-     *                                              recording_status_callback_method
+     * @param string $recordingChannels mono or dualSet this parameter to specify
+     *                                  the number of channels in the final
+     *                                  recording.
+     * @param string $recordingStatusCallback A URL that Twilio will send a webhook
+     *                                        request to when the recording is
+     *                                        available for access.
+     * @param string $recordingStatusCallbackMethod The HTTP method Twilio should
+     *                                              use when requesting the
+     *                                              `RecordingStatusCallback` URL.
      * @param string $sipAuthUsername The sip_auth_username
      * @param string $sipAuthPassword The sip_auth_password
      * @param string $machineDetection Enable machine detection or end of greeting
      *                                 detection
      * @param integer $machineDetectionTimeout Number of miliseconds to wait for
      *                                         machine detection
-     * @param string $recordingStatusCallbackEvent The
-     *                                             recording_status_callback_event
+     * @param string $recordingStatusCallbackEvent The recording status changes
+     *                                             that Twilio will send webhooks
+     *                                             on to the URL specified in
+     *                                             RecordingStatusCallback.
      * @param string $trim Set this parameter to control trimming of silence on the
      *                     recording.
-     * @param string $callerId The phone number, SIP address or Client identifier
+     * @param string $callerId The phone number, SIP address, or Client identifier
      *                         that made this Call. Phone numbers are in E.164
-     *                         format (e.g. +16175551212). SIP addresses are
+     *                         format (e.g., +16175551212). SIP addresses are
      *                         formatted as `name@company.com`.
      * @return CreateCallOptions Options builder
      */
@@ -92,29 +100,37 @@ class CreateCallOptions extends Options {
      * @param string $fallbackUrl Fallback URL in case of error
      * @param string $fallbackMethod HTTP Method to use with FallbackUrl
      * @param string $statusCallback Status Callback URL
-     * @param string $statusCallbackEvent The status_callback_event
+     * @param string $statusCallbackEvent The call progress events that Twilio will
+     *                                    send webhooks on.
      * @param string $statusCallbackMethod HTTP Method to use with StatusCallback
      * @param string $sendDigits Digits to send
-     * @param string $ifMachine Action to take if a machine has answered the call
+     * @param string $ifMachine The if_machine
      * @param integer $timeout Number of seconds to wait for an answer
      * @param boolean $record Whether or not to record the Call
-     * @param string $recordingChannels The recording_channels
-     * @param string $recordingStatusCallback The recording_status_callback
-     * @param string $recordingStatusCallbackMethod The
-     *                                              recording_status_callback_method
+     * @param string $recordingChannels mono or dualSet this parameter to specify
+     *                                  the number of channels in the final
+     *                                  recording.
+     * @param string $recordingStatusCallback A URL that Twilio will send a webhook
+     *                                        request to when the recording is
+     *                                        available for access.
+     * @param string $recordingStatusCallbackMethod The HTTP method Twilio should
+     *                                              use when requesting the
+     *                                              `RecordingStatusCallback` URL.
      * @param string $sipAuthUsername The sip_auth_username
      * @param string $sipAuthPassword The sip_auth_password
      * @param string $machineDetection Enable machine detection or end of greeting
      *                                 detection
      * @param integer $machineDetectionTimeout Number of miliseconds to wait for
      *                                         machine detection
-     * @param string $recordingStatusCallbackEvent The
-     *                                             recording_status_callback_event
+     * @param string $recordingStatusCallbackEvent The recording status changes
+     *                                             that Twilio will send webhooks
+     *                                             on to the URL specified in
+     *                                             RecordingStatusCallback.
      * @param string $trim Set this parameter to control trimming of silence on the
      *                     recording.
-     * @param string $callerId The phone number, SIP address or Client identifier
+     * @param string $callerId The phone number, SIP address, or Client identifier
      *                         that made this Call. Phone numbers are in E.164
-     *                         format (e.g. +16175551212). SIP addresses are
+     *                         format (e.g., +16175551212). SIP addresses are
      *                         formatted as `name@company.com`.
      */
     public function __construct($url = Values::NONE, $applicationSid = Values::NONE, $method = Values::NONE, $fallbackUrl = Values::NONE, $fallbackMethod = Values::NONE, $statusCallback = Values::NONE, $statusCallbackEvent = Values::NONE, $statusCallbackMethod = Values::NONE, $sendDigits = Values::NONE, $ifMachine = Values::NONE, $timeout = Values::NONE, $record = Values::NONE, $recordingChannels = Values::NONE, $recordingStatusCallback = Values::NONE, $recordingStatusCallbackMethod = Values::NONE, $sipAuthUsername = Values::NONE, $sipAuthPassword = Values::NONE, $machineDetection = Values::NONE, $machineDetectionTimeout = Values::NONE, $recordingStatusCallbackEvent = Values::NONE, $trim = Values::NONE, $callerId = Values::NONE) {
@@ -143,7 +159,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The fully qualified URL that should be consulted when the call connects. Just like when you set a URL on a phone number for handling inbound calls.
+     * The fully qualified URL that hosts instructions for the call. Twilio will consult this URL when the call connects. See the [Url Parameter](https://www.twilio.com/docs/voice/make-calls#specify-a-url-parameter) details in [Making Calls](https://www.twilio.com/docs/voice/make-calls) for more details.
      * 
      * @param string $url Url from which to fetch TwiML
      * @return $this Fluent Builder
@@ -154,7 +170,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The 34 character sid of the application Twilio should use to handle this phone call. If this parameter is present, Twilio will ignore all of the voice URLs passed and use the URLs set on the application.
+     * The 34-character SID of the application Twilio should use to handle this phone call. If this parameter is present, Twilio will ignore all of the voice URLs passed and use the URLs set on the application. See the [ApplicationSid Parameter](https://www.twilio.com/docs/voice/make-calls#specify-an-applicationsid-parameter) section in [Making Calls](https://www.twilio.com/docs/voice/make-calls) for more details.
      * 
      * @param string $applicationSid ApplicationSid that configures from where to
      *                               fetch TwiML
@@ -166,7 +182,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio should use when requesting the URL. Defaults to `POST`. If an `ApplicationSid` was provided, this parameter is ignored.
+     * The HTTP method Twilio should use when making its request to the `Url` parameter's value. Defaults to `POST`. If an `ApplicationSid` parameter is present, this parameter is ignored.
      * 
      * @param string $method HTTP method to use to fetch TwiML
      * @return $this Fluent Builder
@@ -177,7 +193,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * A URL that Twilio will request if an error occurs requesting or executing the TwiML at `Url`. If an `ApplicationSid` was provided, this parameter is ignored.
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML at `Url`. If an `ApplicationSid` parameter is present, this parameter is ignored.
      * 
      * @param string $fallbackUrl Fallback URL in case of error
      * @return $this Fluent Builder
@@ -188,7 +204,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The HTTP method that Twilio should use to request the `FallbackUrl`. Must be either `GET` or `POST`. Defaults to `POST`. If an `ApplicationSid` was provided, this parameter is ignored.
+     * The HTTP method that Twilio should use to request the `FallbackUrl`. Must be either `GET` or `POST`. Defaults to `POST`. If an `ApplicationSid` parameter is present, this parameter is ignored.
      * 
      * @param string $fallbackMethod HTTP Method to use with FallbackUrl
      * @return $this Fluent Builder
@@ -199,7 +215,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * A URL that Twilio will request when the call ends to notify your app. If an `ApplicationSid` was provided, this parameter is ignored.
+     * A URL that Twilio will send asynchronous webhook requests to on every call event specified in the `StatusCallbackEvent` parameter. If no event is specified, Twilio will send `completed` by default. If an `ApplicationSid` parameter is present, this parameter is ignored. URLs must contain a valid hostname (underscores are not permitted).
      * 
      * @param string $statusCallback Status Callback URL
      * @return $this Fluent Builder
@@ -210,9 +226,10 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The status_callback_event
+     * The call progress events that will trigger a webhook from Twilio. Available values are `initiated`, `ringing`, `answered`, and `completed`. If no event is specified, defaults to `completed`. If you want to receive multiple events, please provide multiple `StatusCallbackEvent` values as individual parameters in the `POST` request. See the code sample for [monitoring call progress](https://www.twilio.com/docs/voice/api/call?code-sample=code-create-a-call-and-specify-a-statuscallbackevent). If an `ApplicationSid` is present, this parameter is ignored.
      * 
-     * @param string $statusCallbackEvent The status_callback_event
+     * @param string $statusCallbackEvent The call progress events that Twilio will
+     *                                    send webhooks on.
      * @return $this Fluent Builder
      */
     public function setStatusCallbackEvent($statusCallbackEvent) {
@@ -221,7 +238,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The HTTP method that Twilio should use to request the `StatusCallback`. Defaults to `POST`. If an `ApplicationSid` was provided, this parameter is ignored.
+     * The HTTP method Twilio should use when requesting the `StatusCallback` URL. Defaults to `POST`. If an `ApplicationSid` parameter is present, this parameter is ignored.
      * 
      * @param string $statusCallbackMethod HTTP Method to use with StatusCallback
      * @return $this Fluent Builder
@@ -232,7 +249,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * A string of keys to dial after connecting to the number. Valid digits in the string include: any digit (`0`-`9`), '`#`', '`*`' and '`w`' (to insert a half second pause). For example, if you connected to a company phone number, and wanted to pause for one second, dial extension 1234 and then the pound key, use `ww1234#`.
+     * A string of keys to dial after connecting to the number, maximum of 32 digits. Valid digits in the string include: any digit (`0`-`9`), '`#`', '`*`' and '`w`' (to insert a half second pause). For example, if you connected to a company phone number and wanted to pause for one second, dial extension 1234, and then the pound key, use `SendDigits=ww1234#`. Remember to URL-encode this string, since the '`#`' character has special meaning in a URL. If both `SendDigits` and `MachineDetection` parameters are provided, then `MachineDetection` will be ignored.
      * 
      * @param string $sendDigits Digits to send
      * @return $this Fluent Builder
@@ -243,9 +260,9 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * Tell Twilio to try and determine if a machine (like voicemail) or a human has answered the call. Possible value are `Continue` and `Hangup`.
+     * The if_machine
      * 
-     * @param string $ifMachine Action to take if a machine has answered the call
+     * @param string $ifMachine The if_machine
      * @return $this Fluent Builder
      */
     public function setIfMachine($ifMachine) {
@@ -254,7 +271,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The integer number of seconds that Twilio should allow the phone to ring before assuming there is no answer. Default is `60` seconds, the maximum is `999` seconds. Note, you could set this to a low value, such as `15`, to hangup before reaching an answering machine or voicemail.
+     * The integer number of seconds that Twilio should allow the phone to ring before assuming there is no answer. Default is `60` seconds, the maximum is `600` seconds. For some call flows, Twilio will add a 5-second buffer to the timeout value provided, so if you enter a timeout value of 10 seconds, you could see actual timeout closer to 15 seconds. Note, you could set this to a low value like `15` to hang up before reaching an answering machine or voicemail.
      * 
      * @param integer $timeout Number of seconds to wait for an answer
      * @return $this Fluent Builder
@@ -265,7 +282,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * Set this parameter to true to record the entirety of a phone call. The RecordingUrl will be sent to the StatusCallback URL. Defaults to false.
+     * Set this parameter to `true` to record the entirety of a phone call. The `RecordingUrl` will be sent to the `StatusCallback` URL. Defaults to false.
      * 
      * @param boolean $record Whether or not to record the Call
      * @return $this Fluent Builder
@@ -276,9 +293,11 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The recording_channels
+     * `mono` or `dual` – defaults to `mono`. Set this parameter to specify the number of channels in the final recording. In a mono-channel recording, both legs of the call are mixed down into a single channel within a single recording file. With dual-channel recording, both legs use separate channels within a single recording file. In dual-channel recordings, the parent call will always be in the first channel, and the child call will always be in the second channel.
      * 
-     * @param string $recordingChannels The recording_channels
+     * @param string $recordingChannels mono or dualSet this parameter to specify
+     *                                  the number of channels in the final
+     *                                  recording.
      * @return $this Fluent Builder
      */
     public function setRecordingChannels($recordingChannels) {
@@ -287,9 +306,11 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The recording_status_callback
+     * A URL that Twilio will send a webhook request to when the recording is available for access.
      * 
-     * @param string $recordingStatusCallback The recording_status_callback
+     * @param string $recordingStatusCallback A URL that Twilio will send a webhook
+     *                                        request to when the recording is
+     *                                        available for access.
      * @return $this Fluent Builder
      */
     public function setRecordingStatusCallback($recordingStatusCallback) {
@@ -298,10 +319,11 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The recording_status_callback_method
+     * The HTTP method Twilio should use when requesting the `RecordingStatusCallback` URL. Defaults to `POST`.
      * 
-     * @param string $recordingStatusCallbackMethod The
-     *                                              recording_status_callback_method
+     * @param string $recordingStatusCallbackMethod The HTTP method Twilio should
+     *                                              use when requesting the
+     *                                              `RecordingStatusCallback` URL.
      * @return $this Fluent Builder
      */
     public function setRecordingStatusCallbackMethod($recordingStatusCallbackMethod) {
@@ -332,7 +354,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * Twilio will try to detect if a human, fax machine or answering machine has answered the call. Possible value are `Enable` and `DetectMessageEnd`.
+     * Detect if a human, answering machine, or fax has picked up the call. Use `Enable` if you would like Twilio to return an `AnsweredBy` value as soon as it identifies the called party. If you would like to leave a message on an answering machine, specify `DetectMessageEnd`. If both `SendDigits` and `MachineDetection` parameters are provided, then MachineDetection will be ignored. [Detailed documentation is here](https://www.twilio.com/docs/voice/answering-machine-detection).
      * 
      * @param string $machineDetection Enable machine detection or end of greeting
      *                                 detection
@@ -344,7 +366,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The integer number of miliseconds that Twilio should wait while machine_detection is performned before timing out.
+     * The number of seconds that Twilio should attempt to perform answering machine detection before timing out and firing a voice request with `AnsweredBy` of `unknown`. Defaults to 30 seconds.
      * 
      * @param integer $machineDetectionTimeout Number of miliseconds to wait for
      *                                         machine detection
@@ -356,10 +378,12 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The recording_status_callback_event
+     * The recording status events that will trigger Twilio to send webhooks on to the URL specified in `RecordingStatusCallback`. The available values are `in-progress`, `completed`, and `failed`. Defaults are `completed` and `failed`. To specify multiple values, separate them with a space. If any values are specified, the defaults are no longer applicable.
      * 
-     * @param string $recordingStatusCallbackEvent The
-     *                                             recording_status_callback_event
+     * @param string $recordingStatusCallbackEvent The recording status changes
+     *                                             that Twilio will send webhooks
+     *                                             on to the URL specified in
+     *                                             RecordingStatusCallback.
      * @return $this Fluent Builder
      */
     public function setRecordingStatusCallbackEvent($recordingStatusCallbackEvent) {
@@ -368,7 +392,7 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * Set this parameter to control trimming of silence on the recording.  Possible values are `trim-silence` or `do-not-trim`. Defaults to `trim-silence`.
+     * `trim-silence` or `do-not-trim`. Set this parameter to define whether leading and trailing silence is trimmed from the recording.  Defaults to `trim-silence`.
      * 
      * @param string $trim Set this parameter to control trimming of silence on the
      *                     recording.
@@ -380,11 +404,11 @@ class CreateCallOptions extends Options {
     }
 
     /**
-     * The phone number, SIP address or Client identifier that made this Call. Phone numbers are in E.164 format (e.g. +16175551212). SIP addresses are formatted as `name@company.com`.
+     * The phone number, SIP address, or Client identifier that made this Call. Phone numbers are in [E.164 format](https://www.twilio.com/docs/glossary/what-e164) (e.g., +16175551212). SIP addresses are formatted as `name@company.com`.
      * 
-     * @param string $callerId The phone number, SIP address or Client identifier
+     * @param string $callerId The phone number, SIP address, or Client identifier
      *                         that made this Call. Phone numbers are in E.164
-     *                         format (e.g. +16175551212). SIP addresses are
+     *                         format (e.g., +16175551212). SIP addresses are
      *                         formatted as `name@company.com`.
      * @return $this Fluent Builder
      */
@@ -436,7 +460,7 @@ class ReadCallOptions extends Options {
     }
 
     /**
-     * Only show calls to this phone number or Client identifier
+     * Only show calls to this phone number, SIP address, Client identifier or SIM SID.
      * 
      * @param string $to Phone number or Client identifier to filter `to` on
      * @return $this Fluent Builder
@@ -447,7 +471,7 @@ class ReadCallOptions extends Options {
     }
 
     /**
-     * Only show calls from this phone number or Client identifier
+     * Only show calls from this phone number, SIP address, Client identifier or SIM SID.
      * 
      * @param string $from Phone number or Client identifier to filter `from` on
      * @return $this Fluent Builder
@@ -458,7 +482,7 @@ class ReadCallOptions extends Options {
     }
 
     /**
-     * Only show calls spawned by the call with this Sid
+     * Only show calls spawned by the Call with this SID.
      * 
      * @param string $parentCallSid Parent Call Sid to filter on
      * @return $this Fluent Builder
@@ -469,7 +493,7 @@ class ReadCallOptions extends Options {
     }
 
     /**
-     * Only show calls currently in this status
+     * Only show calls currently in the specified status. May be `queued`, `ringing`, `in-progress`, `canceled`, `completed`, `failed`, `busy`, or `no-answer`.
      * 
      * @param string $status Status to filter on
      * @return $this Fluent Builder
@@ -480,7 +504,7 @@ class ReadCallOptions extends Options {
     }
 
     /**
-     * Only show calls that started on this date
+     * Only show calls that started on this date, given as `YYYY-MM-DD`. Also supports inequalities, such as `StartTime<=YYYY-MM-DD` for calls that started at or before midnight on a date, and `StartTime>=YYYY-MM-DD` for calls that started at or after midnight on a date.
      * 
      * @param string $startTimeBefore StartTime to filter on
      * @return $this Fluent Builder
@@ -491,7 +515,7 @@ class ReadCallOptions extends Options {
     }
 
     /**
-     * Only show calls that started on this date
+     * Only show calls that started on this date, given as `YYYY-MM-DD`. Also supports inequalities, such as `StartTime<=YYYY-MM-DD` for calls that started at or before midnight on a date, and `StartTime>=YYYY-MM-DD` for calls that started at or after midnight on a date.
      * 
      * @param string $startTime StartTime to filter on
      * @return $this Fluent Builder
@@ -502,7 +526,7 @@ class ReadCallOptions extends Options {
     }
 
     /**
-     * Only show calls that started on this date
+     * Only show calls that started on this date, given as `YYYY-MM-DD`. Also supports inequalities, such as `StartTime<=YYYY-MM-DD` for calls that started at or before midnight on a date, and `StartTime>=YYYY-MM-DD` for calls that started at or after midnight on a date.
      * 
      * @param string $startTimeAfter StartTime to filter on
      * @return $this Fluent Builder
@@ -513,7 +537,7 @@ class ReadCallOptions extends Options {
     }
 
     /**
-     * Only show call that ended on this date
+     * Only show calls that ended on this date
      * 
      * @param string $endTimeBefore EndTime to filter on
      * @return $this Fluent Builder
@@ -524,7 +548,7 @@ class ReadCallOptions extends Options {
     }
 
     /**
-     * Only show call that ended on this date
+     * Only show calls that ended on this date
      * 
      * @param string $endTime EndTime to filter on
      * @return $this Fluent Builder
@@ -535,7 +559,7 @@ class ReadCallOptions extends Options {
     }
 
     /**
-     * Only show call that ended on this date
+     * Only show calls that ended on this date
      * 
      * @param string $endTimeAfter EndTime to filter on
      * @return $this Fluent Builder
@@ -582,7 +606,7 @@ class UpdateCallOptions extends Options {
     }
 
     /**
-     * A valid URL that returns TwiML. Twilio will immediately redirect the call to the new TwiML upon execution.
+     * that hosts instructions for the call. Twilio will consult this URL when the call connects. See the [Url Parameter](https://www.twilio.com/docs/voice/make-calls#specify-a-url-parameter) section in [Making Calls](https://www.twilio.com/docs/voice/make-calls) for more details.
      * 
      * @param string $url URL that returns TwiML
      * @return $this Fluent Builder
@@ -593,7 +617,7 @@ class UpdateCallOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio should use when requesting the URL. Defaults to `POST`.
+     * The HTTP method Twilio should use when making its request to the `Url` parameter's value. Defaults to `POST`. If an `ApplicationSid` parameter is present, this parameter is ignored.
      * 
      * @param string $method HTTP method to use to fetch TwiML
      * @return $this Fluent Builder
@@ -604,7 +628,7 @@ class UpdateCallOptions extends Options {
     }
 
     /**
-     * Either `canceled` or `completed`. Specifying `canceled` will attempt to hangup calls that are queued or ringing but not affect calls already in progress. Specifying `completed` will attempt to hang up a call even if it's already in progress.
+     * Either `canceled` or `completed`. Specifying `canceled` will attempt to hang up calls that are queued or ringing, but will not affect calls already in progress. Specifying `completed` will attempt to hang up a call even if it's already in progress.
      * 
      * @param string $status Status to update the Call with
      * @return $this Fluent Builder
@@ -615,7 +639,7 @@ class UpdateCallOptions extends Options {
     }
 
     /**
-     * A URL that Twilio will request if an error occurs requesting or executing the TwiML at `Url`.
+     * A URL that Twilio will request if an error occurs when requesting or executing the TwiML at `Url`. If an `ApplicationSid` parameter is present, this parameter is ignored.
      * 
      * @param string $fallbackUrl Fallback URL in case of error
      * @return $this Fluent Builder
@@ -626,7 +650,7 @@ class UpdateCallOptions extends Options {
     }
 
     /**
-     * The HTTP method that Twilio should use to request the `FallbackUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
+     * The HTTP method that Twilio should use to request the `FallbackUrl`. Must be either `GET` or `POST`. Defaults to `POST`. If an `ApplicationSid` parameter is present, this parameter is ignored.
      * 
      * @param string $fallbackMethod HTTP Method to use with FallbackUrl
      * @return $this Fluent Builder
@@ -637,7 +661,7 @@ class UpdateCallOptions extends Options {
     }
 
     /**
-     * A URL that Twilio will request when the call ends to notify your app.
+     * A URL that Twilio will send asynchronous webhook requests to on every call event specified in the `StatusCallbackEvent` parameter. If no event is specified, Twilio will send `completed` by default. If an `ApplicationSid` parameter is present, this parameter is ignored. URLs must contain a valid hostname (underscores are not permitted).
      * 
      * @param string $statusCallback Status Callback URL
      * @return $this Fluent Builder
@@ -648,7 +672,7 @@ class UpdateCallOptions extends Options {
     }
 
     /**
-     * The HTTP method that Twilio should use to request the `StatusCallback`. Defaults to `POST`.
+     * The HTTP method Twilio should use when requesting the `StatusCallback` URL. Defaults to `POST`. If an `ApplicationSid` parameter is present, this parameter is ignored.
      * 
      * @param string $statusCallbackMethod HTTP Method to use with StatusCallback
      * @return $this Fluent Builder

plugins/Twilio/Rest/Api/V2010/Account/CallPage.php

@@ -23,7 +23,7 @@ class ParticipantContext extends InstanceContext {
      * @param string $accountSid The account_sid
      * @param string $conferenceSid The string that uniquely identifies this
      *                              conference
-     * @param string $callSid The call_sid
+     * @param string $callSid Fetch by unique participant Call SID
      * @return \Twilio\Rest\Api\V2010\Account\Conference\ParticipantContext 
      */
     public function __construct(Version $version, $accountSid, $conferenceSid, $callSid) {
@@ -43,6 +43,7 @@ class ParticipantContext extends InstanceContext {
      * Fetch a ParticipantInstance
      * 
      * @return ParticipantInstance Fetched ParticipantInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -67,6 +68,7 @@ class ParticipantContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return ParticipantInstance Updated ParticipantInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);
@@ -100,6 +102,7 @@ class ParticipantContext extends InstanceContext {
      * Deletes the ParticipantInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/Conference/ParticipantInstance.php

@@ -38,7 +38,7 @@ class ParticipantInstance extends InstanceResource {
      * @param string $accountSid The unique sid that identifies this account
      * @param string $conferenceSid A string that uniquely identifies this
      *                              conference
-     * @param string $callSid The call_sid
+     * @param string $callSid Fetch by unique participant Call SID
      * @return \Twilio\Rest\Api\V2010\Account\Conference\ParticipantInstance 
      */
     public function __construct(Version $version, array $payload, $accountSid, $conferenceSid, $callSid = null) {
@@ -92,6 +92,7 @@ class ParticipantInstance extends InstanceResource {
      * Fetch a ParticipantInstance
      * 
      * @return ParticipantInstance Fetched ParticipantInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -102,6 +103,7 @@ class ParticipantInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return ParticipantInstance Updated ParticipantInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);
@@ -111,6 +113,7 @@ class ParticipantInstance extends InstanceResource {
      * Deletes the ParticipantInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/Conference/ParticipantList.php

@@ -37,10 +37,12 @@ class ParticipantList extends ListResource {
     /**
      * Create a new ParticipantInstance
      * 
-     * @param string $from The from
-     * @param string $to The to
+     * @param string $from The `from` phone number used to invite a participant.
+     * @param string $to The number, client id, or sip address of the new
+     *                   participant.
      * @param array|Options $options Optional Arguments
      * @return ParticipantInstance Newly created ParticipantInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($from, $to, $options = array()) {
         $options = new Values($options);
@@ -188,7 +190,7 @@ class ParticipantList extends ListResource {
     /**
      * Constructs a ParticipantContext
      * 
-     * @param string $callSid The call_sid
+     * @param string $callSid Fetch by unique participant Call SID
      * @return \Twilio\Rest\Api\V2010\Account\Conference\ParticipantContext 
      */
     public function getContext($callSid) {

plugins/Twilio/Rest/Api/V2010/Account/Conference/ParticipantOptions.php

@@ -15,11 +15,14 @@ use Twilio\Values;
 abstract class ParticipantOptions {
     /**
      * @param boolean $muted Indicates if the participant should be muted
-     * @param boolean $hold The hold
-     * @param string $holdUrl The hold_url
-     * @param string $holdMethod The hold_method
-     * @param string $announceUrl The announce_url
-     * @param string $announceMethod The announce_method
+     * @param boolean $hold Specifying true will hold the participant, while false
+     *                      will un-hold.
+     * @param string $holdUrl The 'HoldUrl' attribute lets you specify a URL for
+     *                        music that plays when a participant is held.
+     * @param string $holdMethod Specify GET or POST, defaults to GET
+     * @param string $announceUrl The 'AnnounceUrl' attribute lets you specify a
+     *                            URL for announcing something to the participant.
+     * @param string $announceMethod Specify GET or POST, defaults to POST
      * @return UpdateParticipantOptions Options builder
      */
     public static function update($muted = Values::NONE, $hold = Values::NONE, $holdUrl = Values::NONE, $holdMethod = Values::NONE, $announceUrl = Values::NONE, $announceMethod = Values::NONE) {
@@ -27,37 +30,46 @@ abstract class ParticipantOptions {
     }
 
     /**
-     * @param string $statusCallback The status_callback
-     * @param string $statusCallbackMethod The status_callback_method
-     * @param string $statusCallbackEvent The status_callback_event
-     * @param integer $timeout The timeout
-     * @param boolean $record The record
-     * @param boolean $muted The muted
-     * @param string $beep The beep
-     * @param boolean $startConferenceOnEnter The start_conference_on_enter
-     * @param boolean $endConferenceOnExit The end_conference_on_exit
-     * @param string $waitUrl The wait_url
-     * @param string $waitMethod The wait_method
-     * @param boolean $earlyMedia The early_media
-     * @param integer $maxParticipants The max_participants
-     * @param string $conferenceRecord The conference_record
-     * @param string $conferenceTrim The conference_trim
-     * @param string $conferenceStatusCallback The conference_status_callback
-     * @param string $conferenceStatusCallbackMethod The
-     *                                               conference_status_callback_method
-     * @param string $conferenceStatusCallbackEvent The
-     *                                              conference_status_callback_event
-     * @param string $recordingChannels The recording_channels
-     * @param string $recordingStatusCallback The recording_status_callback
-     * @param string $recordingStatusCallbackMethod The
-     *                                              recording_status_callback_method
-     * @param string $sipAuthUsername The sip_auth_username
-     * @param string $sipAuthPassword The sip_auth_password
-     * @param string $region The region
-     * @param string $conferenceRecordingStatusCallback The
-     *                                                  conference_recording_status_callback
-     * @param string $conferenceRecordingStatusCallbackMethod The
-     *                                                        conference_recording_status_callback_method
+     * @param string $statusCallback URL for conference event callback.
+     * @param string $statusCallbackMethod Method Twilio should use to reach the
+     *                                     status callback URL.
+     * @param string $statusCallbackEvent Set state change events that will trigger
+     *                                    a callback.
+     * @param integer $timeout Number of seconds Twilio will wait for an answer.
+     * @param boolean $record Record the agent and their conferences.
+     * @param boolean $muted Mute the agent.
+     * @param string $beep Play a beep when the participant joins the conference.
+     * @param boolean $startConferenceOnEnter Begin the conference when the
+     *                                        participant joins.
+     * @param boolean $endConferenceOnExit End the conference when the participant
+     *                                     leaves.
+     * @param string $waitUrl URL that hosts pre-conference hold music
+     * @param string $waitMethod The method Twilio should use to request `WaitUrl`.
+     * @param boolean $earlyMedia Agents can hear the state of the outbound call.
+     * @param integer $maxParticipants Maximum number of agent conference
+     *                                 participants.
+     * @param string $conferenceRecord Record the conference.
+     * @param string $conferenceTrim Trim silence from audio files.
+     * @param string $conferenceStatusCallback Callback URL for conference events.
+     * @param string $conferenceStatusCallbackMethod HTTP method for requesting
+     *                                               `ConferenceStatusCallback` URL.
+     * @param string $conferenceStatusCallbackEvent Set which conference state
+     *                                              changes should webhook to the
+     *                                              `ConferenceStatusCallback`
+     * @param string $recordingChannels Specify `mono` or `dual` recording channels.
+     * @param string $recordingStatusCallback The absolute URL for Twilio's webhook
+     *                                        with recording status information.
+     * @param string $recordingStatusCallbackMethod HTTP method for
+     *                                              `RecordingStatusCallback`
+     * @param string $sipAuthUsername SIP username used for authenticating.
+     * @param string $sipAuthPassword SIP password for authentication.
+     * @param string $region The region where Twilio should mix the conference
+     *                       audio.
+     * @param string $conferenceRecordingStatusCallback Conference recording
+     *                                                  callback URL.
+     * @param string $conferenceRecordingStatusCallbackMethod Method Twilio should
+     *                                                        use to request the
+     *                                                        `ConferenceRecordingStatusCallback` URL.
      * @param string $recordingStatusCallbackEvent The
      *                                             recording_status_callback_event
      * @param string $conferenceRecordingStatusCallbackEvent The
@@ -70,7 +82,7 @@ abstract class ParticipantOptions {
 
     /**
      * @param boolean $muted Filter by muted participants
-     * @param boolean $hold The hold
+     * @param boolean $hold Only show participants that are held or unheld.
      * @return ReadParticipantOptions Options builder
      */
     public static function read($muted = Values::NONE, $hold = Values::NONE) {
@@ -81,11 +93,14 @@ abstract class ParticipantOptions {
 class UpdateParticipantOptions extends Options {
     /**
      * @param boolean $muted Indicates if the participant should be muted
-     * @param boolean $hold The hold
-     * @param string $holdUrl The hold_url
-     * @param string $holdMethod The hold_method
-     * @param string $announceUrl The announce_url
-     * @param string $announceMethod The announce_method
+     * @param boolean $hold Specifying true will hold the participant, while false
+     *                      will un-hold.
+     * @param string $holdUrl The 'HoldUrl' attribute lets you specify a URL for
+     *                        music that plays when a participant is held.
+     * @param string $holdMethod Specify GET or POST, defaults to GET
+     * @param string $announceUrl The 'AnnounceUrl' attribute lets you specify a
+     *                            URL for announcing something to the participant.
+     * @param string $announceMethod Specify GET or POST, defaults to POST
      */
     public function __construct($muted = Values::NONE, $hold = Values::NONE, $holdUrl = Values::NONE, $holdMethod = Values::NONE, $announceUrl = Values::NONE, $announceMethod = Values::NONE) {
         $this->options['muted'] = $muted;
@@ -97,7 +112,7 @@ class UpdateParticipantOptions extends Options {
     }
 
     /**
-     * Indicates if the participant should be muted
+     * Specifying `true` will mute the participant, while `false` will un-mute. Anything other than `true` or `false` is interpreted as `false`.
      * 
      * @param boolean $muted Indicates if the participant should be muted
      * @return $this Fluent Builder
@@ -108,9 +123,10 @@ class UpdateParticipantOptions extends Options {
     }
 
     /**
-     * The hold
+     * Specifying `true` will hold the participant, while `false` will remove them from hold.
      * 
-     * @param boolean $hold The hold
+     * @param boolean $hold Specifying true will hold the participant, while false
+     *                      will un-hold.
      * @return $this Fluent Builder
      */
     public function setHold($hold) {
@@ -119,9 +135,10 @@ class UpdateParticipantOptions extends Options {
     }
 
     /**
-     * The hold_url
+     * The 'HoldUrl' attribute lets you specify a URL for music that plays when a participant is on hold. The URL may be an MP3, a WAV or a TwiML document that uses `<Play>`, `<Say>` or `<Redirect>`.
      * 
-     * @param string $holdUrl The hold_url
+     * @param string $holdUrl The 'HoldUrl' attribute lets you specify a URL for
+     *                        music that plays when a participant is held.
      * @return $this Fluent Builder
      */
     public function setHoldUrl($holdUrl) {
@@ -130,9 +147,9 @@ class UpdateParticipantOptions extends Options {
     }
 
     /**
-     * The hold_method
+     * Specify the HTTP method Twilio should use to request your `HoldUrl`, either `GET` or `POST`. Defaults to `GET`.
      * 
-     * @param string $holdMethod The hold_method
+     * @param string $holdMethod Specify GET or POST, defaults to GET
      * @return $this Fluent Builder
      */
     public function setHoldMethod($holdMethod) {
@@ -141,9 +158,10 @@ class UpdateParticipantOptions extends Options {
     }
 
     /**
-     * The announce_url
+     * The 'AnnounceUrl' attribute lets you specify a URL for announcing something to the participant. The URL may return an MP3, a WAV or a TwiML document with `<Play>` or `<Say>`.
      * 
-     * @param string $announceUrl The announce_url
+     * @param string $announceUrl The 'AnnounceUrl' attribute lets you specify a
+     *                            URL for announcing something to the participant.
      * @return $this Fluent Builder
      */
     public function setAnnounceUrl($announceUrl) {
@@ -152,9 +170,9 @@ class UpdateParticipantOptions extends Options {
     }
 
     /**
-     * The announce_method
+     * Specify the HTTP method Twilio should use to request your `AnnounceUrl`, either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $announceMethod The announce_method
+     * @param string $announceMethod Specify GET or POST, defaults to POST
      * @return $this Fluent Builder
      */
     public function setAnnounceMethod($announceMethod) {
@@ -180,37 +198,46 @@ class UpdateParticipantOptions extends Options {
 
 class CreateParticipantOptions extends Options {
     /**
-     * @param string $statusCallback The status_callback
-     * @param string $statusCallbackMethod The status_callback_method
-     * @param string $statusCallbackEvent The status_callback_event
-     * @param integer $timeout The timeout
-     * @param boolean $record The record
-     * @param boolean $muted The muted
-     * @param string $beep The beep
-     * @param boolean $startConferenceOnEnter The start_conference_on_enter
-     * @param boolean $endConferenceOnExit The end_conference_on_exit
-     * @param string $waitUrl The wait_url
-     * @param string $waitMethod The wait_method
-     * @param boolean $earlyMedia The early_media
-     * @param integer $maxParticipants The max_participants
-     * @param string $conferenceRecord The conference_record
-     * @param string $conferenceTrim The conference_trim
-     * @param string $conferenceStatusCallback The conference_status_callback
-     * @param string $conferenceStatusCallbackMethod The
-     *                                               conference_status_callback_method
-     * @param string $conferenceStatusCallbackEvent The
-     *                                              conference_status_callback_event
-     * @param string $recordingChannels The recording_channels
-     * @param string $recordingStatusCallback The recording_status_callback
-     * @param string $recordingStatusCallbackMethod The
-     *                                              recording_status_callback_method
-     * @param string $sipAuthUsername The sip_auth_username
-     * @param string $sipAuthPassword The sip_auth_password
-     * @param string $region The region
-     * @param string $conferenceRecordingStatusCallback The
-     *                                                  conference_recording_status_callback
-     * @param string $conferenceRecordingStatusCallbackMethod The
-     *                                                        conference_recording_status_callback_method
+     * @param string $statusCallback URL for conference event callback.
+     * @param string $statusCallbackMethod Method Twilio should use to reach the
+     *                                     status callback URL.
+     * @param string $statusCallbackEvent Set state change events that will trigger
+     *                                    a callback.
+     * @param integer $timeout Number of seconds Twilio will wait for an answer.
+     * @param boolean $record Record the agent and their conferences.
+     * @param boolean $muted Mute the agent.
+     * @param string $beep Play a beep when the participant joins the conference.
+     * @param boolean $startConferenceOnEnter Begin the conference when the
+     *                                        participant joins.
+     * @param boolean $endConferenceOnExit End the conference when the participant
+     *                                     leaves.
+     * @param string $waitUrl URL that hosts pre-conference hold music
+     * @param string $waitMethod The method Twilio should use to request `WaitUrl`.
+     * @param boolean $earlyMedia Agents can hear the state of the outbound call.
+     * @param integer $maxParticipants Maximum number of agent conference
+     *                                 participants.
+     * @param string $conferenceRecord Record the conference.
+     * @param string $conferenceTrim Trim silence from audio files.
+     * @param string $conferenceStatusCallback Callback URL for conference events.
+     * @param string $conferenceStatusCallbackMethod HTTP method for requesting
+     *                                               `ConferenceStatusCallback` URL.
+     * @param string $conferenceStatusCallbackEvent Set which conference state
+     *                                              changes should webhook to the
+     *                                              `ConferenceStatusCallback`
+     * @param string $recordingChannels Specify `mono` or `dual` recording channels.
+     * @param string $recordingStatusCallback The absolute URL for Twilio's webhook
+     *                                        with recording status information.
+     * @param string $recordingStatusCallbackMethod HTTP method for
+     *                                              `RecordingStatusCallback`
+     * @param string $sipAuthUsername SIP username used for authenticating.
+     * @param string $sipAuthPassword SIP password for authentication.
+     * @param string $region The region where Twilio should mix the conference
+     *                       audio.
+     * @param string $conferenceRecordingStatusCallback Conference recording
+     *                                                  callback URL.
+     * @param string $conferenceRecordingStatusCallbackMethod Method Twilio should
+     *                                                        use to request the
+     *                                                        `ConferenceRecordingStatusCallback` URL.
      * @param string $recordingStatusCallbackEvent The
      *                                             recording_status_callback_event
      * @param string $conferenceRecordingStatusCallbackEvent The
@@ -248,9 +275,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The status_callback
+     * The absolute URL where Twilio should send a webhook with conference event information that you request with the `StatusCallbackEvent` parameter.
      * 
-     * @param string $statusCallback The status_callback
+     * @param string $statusCallback URL for conference event callback.
      * @return $this Fluent Builder
      */
     public function setStatusCallback($statusCallback) {
@@ -259,9 +286,10 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The status_callback_method
+     * The method Twilio should use when requesting your `StatusCallback` URL. Options are `GET` and `POST`. Defaults to `POST`.
      * 
-     * @param string $statusCallbackMethod The status_callback_method
+     * @param string $statusCallbackMethod Method Twilio should use to reach the
+     *                                     status callback URL.
      * @return $this Fluent Builder
      */
     public function setStatusCallbackMethod($statusCallbackMethod) {
@@ -270,9 +298,10 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The status_callback_event
+     * Specifies which conference state changes should generate a webhook to the `StatusCallback` URL. Options are `initiated`, `ringing`, `answered`, and `completed`. To specify multiple values, separate each with a space. Defaults to `completed`.
      * 
-     * @param string $statusCallbackEvent The status_callback_event
+     * @param string $statusCallbackEvent Set state change events that will trigger
+     *                                    a callback.
      * @return $this Fluent Builder
      */
     public function setStatusCallbackEvent($statusCallbackEvent) {
@@ -281,9 +310,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The timeout
+     * The number of seconds (integer) that Twilio should allow the phone to ring before assuming there is no answer. Defaults to 60 seconds. Minimum allowed timeout is `5`, max is `600`. Twilio always adds a 5-second timeout buffer to outgoing calls, so if you enter a timeout value of 10 seconds, you will see an actual timeout closer to 15 seconds.
      * 
-     * @param integer $timeout The timeout
+     * @param integer $timeout Number of seconds Twilio will wait for an answer.
      * @return $this Fluent Builder
      */
     public function setTimeout($timeout) {
@@ -292,9 +321,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The record
+     * Records the agent and their conferences, including downtime between conferences. Values may be `true` or `false`. Defaults to `false`.
      * 
-     * @param boolean $record The record
+     * @param boolean $record Record the agent and their conferences.
      * @return $this Fluent Builder
      */
     public function setRecord($record) {
@@ -303,9 +332,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The muted
+     * Specify whether the agent can speak in the conference. Values can be `true` or `false`. Defaults to `false`.
      * 
-     * @param boolean $muted The muted
+     * @param boolean $muted Mute the agent.
      * @return $this Fluent Builder
      */
     public function setMuted($muted) {
@@ -314,9 +343,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The beep
+     * Play a notification beep to the conference when this participant joins. Options are `true`, `false`, `onEnter`, or `onExit`. Defaults to `true`.
      * 
-     * @param string $beep The beep
+     * @param string $beep Play a beep when the participant joins the conference.
      * @return $this Fluent Builder
      */
     public function setBeep($beep) {
@@ -325,9 +354,10 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The start_conference_on_enter
+     * If the conference has not already begun, `true` will start the conference when this participant joins. Specifying `false` will mute the participant and play background music until the conference begins. Defaults to `true`.
      * 
-     * @param boolean $startConferenceOnEnter The start_conference_on_enter
+     * @param boolean $startConferenceOnEnter Begin the conference when the
+     *                                        participant joins.
      * @return $this Fluent Builder
      */
     public function setStartConferenceOnEnter($startConferenceOnEnter) {
@@ -336,9 +366,10 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The end_conference_on_exit
+     * If `true`, will end the conference when this participant leaves. Defaults to `false`.
      * 
-     * @param boolean $endConferenceOnExit The end_conference_on_exit
+     * @param boolean $endConferenceOnExit End the conference when the participant
+     *                                     leaves.
      * @return $this Fluent Builder
      */
     public function setEndConferenceOnExit($endConferenceOnExit) {
@@ -347,9 +378,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The wait_url
+     * Specify an absolute URL that hosts music to play before the  conference starts. Defualts to Twilio's standard [hold music](https://www.twilio.com/labs/twimlets/holdmusic).
      * 
-     * @param string $waitUrl The wait_url
+     * @param string $waitUrl URL that hosts pre-conference hold music
      * @return $this Fluent Builder
      */
     public function setWaitUrl($waitUrl) {
@@ -358,9 +389,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The wait_method
+     * Specify which method, `GET` or `POST`, Twilio should use to request the `WaitUrl` for this conference. Be sure to use `GET` if you are directly requesting static audio files so that Twilio properly caches the files. Defaults to `POST`.
      * 
-     * @param string $waitMethod The wait_method
+     * @param string $waitMethod The method Twilio should use to request `WaitUrl`.
      * @return $this Fluent Builder
      */
     public function setWaitMethod($waitMethod) {
@@ -369,9 +400,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The early_media
+     * Allow an agent to hear the state of the outbound call, including ringing or disconnect messages. Can be `true` or `false`. Defaults to `true`.
      * 
-     * @param boolean $earlyMedia The early_media
+     * @param boolean $earlyMedia Agents can hear the state of the outbound call.
      * @return $this Fluent Builder
      */
     public function setEarlyMedia($earlyMedia) {
@@ -380,9 +411,10 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The max_participants
+     * The maximum number of participants within this agent conference. Values can be positive integers from `2`-`10`. Defaults to `10`.
      * 
-     * @param integer $maxParticipants The max_participants
+     * @param integer $maxParticipants Maximum number of agent conference
+     *                                 participants.
      * @return $this Fluent Builder
      */
     public function setMaxParticipants($maxParticipants) {
@@ -391,9 +423,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The conference_record
+     * Records the conference that this participant is joining. Options are `true`, `false`, `record-from-start`, and `do-not-record`. Deafults to `false`
      * 
-     * @param string $conferenceRecord The conference_record
+     * @param string $conferenceRecord Record the conference.
      * @return $this Fluent Builder
      */
     public function setConferenceRecord($conferenceRecord) {
@@ -402,9 +434,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The conference_trim
+     * Specify whether to trim leading and trailing silence from your recorded conference audio files. Options are `trim-silence` and `do-not-trim`. Defaults to `trim-silence`
      * 
-     * @param string $conferenceTrim The conference_trim
+     * @param string $conferenceTrim Trim silence from audio files.
      * @return $this Fluent Builder
      */
     public function setConferenceTrim($conferenceTrim) {
@@ -413,9 +445,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The conference_status_callback
+     * The absolute URL Twilio should request with conference events specified in `ConferenceStatusCallbackEvent`. This value is set by the first Participant to join the conference, and subsequent callback URLs will be ignored.
      * 
-     * @param string $conferenceStatusCallback The conference_status_callback
+     * @param string $conferenceStatusCallback Callback URL for conference events.
      * @return $this Fluent Builder
      */
     public function setConferenceStatusCallback($conferenceStatusCallback) {
@@ -424,10 +456,10 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The conference_status_callback_method
+     * The HTTP method Twilio should use when requesting the `ConferenceStatusCallback` URL. Either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $conferenceStatusCallbackMethod The
-     *                                               conference_status_callback_method
+     * @param string $conferenceStatusCallbackMethod HTTP method for requesting
+     *                                               `ConferenceStatusCallback` URL.
      * @return $this Fluent Builder
      */
     public function setConferenceStatusCallbackMethod($conferenceStatusCallbackMethod) {
@@ -436,10 +468,11 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The conference_status_callback_event
+     * Specifies which conference state changes should generate a webhook to the URL specified in the `ConferenceStatusCallback` attribute. Available values are `start`, `end`, `join`, `leave`, `mute`, `hold`, and `speaker`. To specify multiple values, separate them with a space. Defaults to `start` and `end`.
      * 
-     * @param string $conferenceStatusCallbackEvent The
-     *                                              conference_status_callback_event
+     * @param string $conferenceStatusCallbackEvent Set which conference state
+     *                                              changes should webhook to the
+     *                                              `ConferenceStatusCallback`
      * @return $this Fluent Builder
      */
     public function setConferenceStatusCallbackEvent($conferenceStatusCallbackEvent) {
@@ -448,9 +481,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The recording_channels
+     * Set the recording channels for the final agent/conference recording. Either `mono` or `dual`. Defaults to `mono`.
      * 
-     * @param string $recordingChannels The recording_channels
+     * @param string $recordingChannels Specify `mono` or `dual` recording channels.
      * @return $this Fluent Builder
      */
     public function setRecordingChannels($recordingChannels) {
@@ -459,9 +492,10 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The recording_status_callback
+     * Specifies the `absolute URL` that Twilio should request when the recording is available if the agent and conference are recorded.
      * 
-     * @param string $recordingStatusCallback The recording_status_callback
+     * @param string $recordingStatusCallback The absolute URL for Twilio's webhook
+     *                                        with recording status information.
      * @return $this Fluent Builder
      */
     public function setRecordingStatusCallback($recordingStatusCallback) {
@@ -470,10 +504,10 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The recording_status_callback_method
+     * The HTTP method Twilio should use when requesting the `RecordingStatusCallback`. `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $recordingStatusCallbackMethod The
-     *                                              recording_status_callback_method
+     * @param string $recordingStatusCallbackMethod HTTP method for
+     *                                              `RecordingStatusCallback`
      * @return $this Fluent Builder
      */
     public function setRecordingStatusCallbackMethod($recordingStatusCallbackMethod) {
@@ -482,9 +516,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The sip_auth_username
+     * SIP username used for authenticating.
      * 
-     * @param string $sipAuthUsername The sip_auth_username
+     * @param string $sipAuthUsername SIP username used for authenticating.
      * @return $this Fluent Builder
      */
     public function setSipAuthUsername($sipAuthUsername) {
@@ -493,9 +527,9 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The sip_auth_password
+     * SIP password for authentication.
      * 
-     * @param string $sipAuthPassword The sip_auth_password
+     * @param string $sipAuthPassword SIP password for authentication.
      * @return $this Fluent Builder
      */
     public function setSipAuthPassword($sipAuthPassword) {
@@ -504,9 +538,10 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The region
+     * Specifies the [region](https://support.twilio.com/hc/en-us/articles/223132167-How-global-low-latency-routing-and-region-selection-work-for-conferences-and-Client-calls) where Twilio should mix the recorded audio. Options are `us1`, `ie1`, `de1`, `sg1`, `br1`, `au1`, `jp1`.
      * 
-     * @param string $region The region
+     * @param string $region The region where Twilio should mix the conference
+     *                       audio.
      * @return $this Fluent Builder
      */
     public function setRegion($region) {
@@ -515,10 +550,10 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The conference_recording_status_callback
+     * The `absolute URL` Twilio should request when the conference recording is available.
      * 
-     * @param string $conferenceRecordingStatusCallback The
-     *                                                  conference_recording_status_callback
+     * @param string $conferenceRecordingStatusCallback Conference recording
+     *                                                  callback URL.
      * @return $this Fluent Builder
      */
     public function setConferenceRecordingStatusCallback($conferenceRecordingStatusCallback) {
@@ -527,10 +562,11 @@ class CreateParticipantOptions extends Options {
     }
 
     /**
-     * The conference_recording_status_callback_method
+     * The HTTP method Twilio should use when requesting your recording status callback URL, either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $conferenceRecordingStatusCallbackMethod The
-     *                                                        conference_recording_status_callback_method
+     * @param string $conferenceRecordingStatusCallbackMethod Method Twilio should
+     *                                                        use to request the
+     *                                                        `ConferenceRecordingStatusCallback` URL.
      * @return $this Fluent Builder
      */
     public function setConferenceRecordingStatusCallbackMethod($conferenceRecordingStatusCallbackMethod) {
@@ -581,7 +617,7 @@ class CreateParticipantOptions extends Options {
 class ReadParticipantOptions extends Options {
     /**
      * @param boolean $muted Filter by muted participants
-     * @param boolean $hold The hold
+     * @param boolean $hold Only show participants that are held or unheld.
      */
     public function __construct($muted = Values::NONE, $hold = Values::NONE) {
         $this->options['muted'] = $muted;
@@ -589,7 +625,7 @@ class ReadParticipantOptions extends Options {
     }
 
     /**
-     * Only show participants that are muted or unmuted
+     * Only return participants that are muted or unmuted. Either `true` or `false`.
      * 
      * @param boolean $muted Filter by muted participants
      * @return $this Fluent Builder
@@ -600,9 +636,9 @@ class ReadParticipantOptions extends Options {
     }
 
     /**
-     * The hold
+     * Only return participants that are on hold or not on hold. Either `true` or `false`.
      * 
-     * @param boolean $hold The hold
+     * @param boolean $hold Only show participants that are held or unheld.
      * @return $this Fluent Builder
      */
     public function setHold($hold) {

plugins/Twilio/Rest/Api/V2010/Account/Conference/ParticipantPage.php

@@ -13,15 +13,19 @@ use Twilio\Exceptions\TwilioException;
 use Twilio\InstanceContext;
 use Twilio\Options;
 use Twilio\Rest\Api\V2010\Account\Conference\ParticipantList;
+use Twilio\Rest\Api\V2010\Account\Conference\RecordingList;
 use Twilio\Values;
 use Twilio\Version;
 
 /**
  * @property \Twilio\Rest\Api\V2010\Account\Conference\ParticipantList participants
+ * @property \Twilio\Rest\Api\V2010\Account\Conference\RecordingList recordings
  * @method \Twilio\Rest\Api\V2010\Account\Conference\ParticipantContext participants(string $callSid)
+ * @method \Twilio\Rest\Api\V2010\Account\Conference\RecordingContext recordings(string $sid)
  */
 class ConferenceContext extends InstanceContext {
     protected $_participants = null;
+    protected $_recordings = null;
 
     /**
      * Initialize the ConferenceContext
@@ -44,6 +48,7 @@ class ConferenceContext extends InstanceContext {
      * Fetch a ConferenceInstance
      * 
      * @return ConferenceInstance Fetched ConferenceInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -67,6 +72,7 @@ class ConferenceContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return ConferenceInstance Updated ConferenceInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);
@@ -109,6 +115,23 @@ class ConferenceContext extends InstanceContext {
         return $this->_participants;
     }
 
+    /**
+     * Access the recordings
+     * 
+     * @return \Twilio\Rest\Api\V2010\Account\Conference\RecordingList 
+     */
+    protected function getRecordings() {
+        if (!$this->_recordings) {
+            $this->_recordings = new RecordingList(
+                $this->version,
+                $this->solution['accountSid'],
+                $this->solution['sid']
+            );
+        }
+
+        return $this->_recordings;
+    }
+
     /**
      * Magic getter to lazy load subresources
      * 

plugins/Twilio/Rest/Api/V2010/Account/ConferenceInstance.php

@@ -30,6 +30,7 @@ use Twilio\Version;
  */
 class ConferenceInstance extends InstanceResource {
     protected $_participants = null;
+    protected $_recordings = null;
 
     /**
      * Initialize the ConferenceInstance
@@ -83,6 +84,7 @@ class ConferenceInstance extends InstanceResource {
      * Fetch a ConferenceInstance
      * 
      * @return ConferenceInstance Fetched ConferenceInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -93,6 +95,7 @@ class ConferenceInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return ConferenceInstance Updated ConferenceInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);
@@ -107,6 +110,15 @@ class ConferenceInstance extends InstanceResource {
         return $this->proxy()->participants;
     }
 
+    /**
+     * Access the recordings
+     * 
+     * @return \Twilio\Rest\Api\V2010\Account\Conference\RecordingList 
+     */
+    protected function getRecordings() {
+        return $this->proxy()->recordings;
+    }
+
     /**
      * Magic getter to access properties
      * 

plugins/Twilio/Rest/Api/V2010/Account/ConferenceList.php

@@ -29,9 +29,11 @@ abstract class ConferenceOptions {
     }
 
     /**
-     * @param string $status The status
-     * @param string $announceUrl The announce_url
-     * @param string $announceMethod The announce_method
+     * @param string $status Specifying completed will end the conference and kick
+     *                       all participants
+     * @param string $announceUrl The 'AnnounceUrl' attribute lets you specify a
+     *                            URL for announcing something into a conference.
+     * @param string $announceMethod Specify GET or POST, defaults to POST
      * @return UpdateConferenceOptions Options builder
      */
     public static function update($status = Values::NONE, $announceUrl = Values::NONE, $announceMethod = Values::NONE) {
@@ -62,7 +64,7 @@ class ReadConferenceOptions extends Options {
     }
 
     /**
-     * Only show conferences that started on this date, given as YYYY-MM-DD. You can also specify inequality such as DateCreated<=YYYY-MM-DD
+     * Only show conferences that started on this date, given as `YYYY-MM-DD`. You can also specify inequality – for conferences that started at or before midnight on a date use  `DateCreated<=YYYY-MM-DD`, or specify  conferences that started at or after midnight on a date with `DateCreated>=YYYY-MM-DD`.
      * 
      * @param string $dateCreatedBefore Filter by date created
      * @return $this Fluent Builder
@@ -73,7 +75,7 @@ class ReadConferenceOptions extends Options {
     }
 
     /**
-     * Only show conferences that started on this date, given as YYYY-MM-DD. You can also specify inequality such as DateCreated&lt;=YYYY-MM-DD
+     * Only show conferences that started on this date, given as `YYYY-MM-DD`. You can also specify inequality – for conferences that started at or before midnight on a date use  `DateCreated<=YYYY-MM-DD`, or specify  conferences that started at or after midnight on a date with `DateCreated>=YYYY-MM-DD`.
      * 
      * @param string $dateCreated Filter by date created
      * @return $this Fluent Builder
@@ -84,7 +86,7 @@ class ReadConferenceOptions extends Options {
     }
 
     /**
-     * Only show conferences that started on this date, given as YYYY-MM-DD. You can also specify inequality such as DateCreated&lt;=YYYY-MM-DD
+     * Only show conferences that started on this date, given as `YYYY-MM-DD`. You can also specify inequality – for conferences that started at or before midnight on a date use  `DateCreated<=YYYY-MM-DD`, or specify  conferences that started at or after midnight on a date with `DateCreated>=YYYY-MM-DD`.
      * 
      * @param string $dateCreatedAfter Filter by date created
      * @return $this Fluent Builder
@@ -95,7 +97,7 @@ class ReadConferenceOptions extends Options {
     }
 
     /**
-     * Only show conferences that were last updated on this date, given as YYYY-MM-DD. You can also specify inequality such as DateUpdated&gt;=YYYY-MM-DD
+     * Only show conferences that were last updated on this date, given as `YYYY-MM-DD`. You can also specify inequality – for conferences that were last updated at or before midnight on a date use `DateUpdated<=YYYY-MM-DD`, or specify conferences updated at or after midnight on a given date with   `DateUpdated>=YYYY-MM-DD`.
      * 
      * @param string $dateUpdatedBefore Filter by date updated
      * @return $this Fluent Builder
@@ -106,7 +108,7 @@ class ReadConferenceOptions extends Options {
     }
 
     /**
-     * Only show conferences that were last updated on this date, given as YYYY-MM-DD. You can also specify inequality such as DateUpdated&gt;=YYYY-MM-DD
+     * Only show conferences that were last updated on this date, given as `YYYY-MM-DD`. You can also specify inequality – for conferences that were last updated at or before midnight on a date use `DateUpdated<=YYYY-MM-DD`, or specify conferences updated at or after midnight on a given date with   `DateUpdated>=YYYY-MM-DD`.
      * 
      * @param string $dateUpdated Filter by date updated
      * @return $this Fluent Builder
@@ -117,7 +119,7 @@ class ReadConferenceOptions extends Options {
     }
 
     /**
-     * Only show conferences that were last updated on this date, given as YYYY-MM-DD. You can also specify inequality such as DateUpdated&gt;=YYYY-MM-DD
+     * Only show conferences that were last updated on this date, given as `YYYY-MM-DD`. You can also specify inequality – for conferences that were last updated at or before midnight on a date use `DateUpdated<=YYYY-MM-DD`, or specify conferences updated at or after midnight on a given date with   `DateUpdated>=YYYY-MM-DD`.
      * 
      * @param string $dateUpdatedAfter Filter by date updated
      * @return $this Fluent Builder
@@ -167,9 +169,11 @@ class ReadConferenceOptions extends Options {
 
 class UpdateConferenceOptions extends Options {
     /**
-     * @param string $status The status
-     * @param string $announceUrl The announce_url
-     * @param string $announceMethod The announce_method
+     * @param string $status Specifying completed will end the conference and kick
+     *                       all participants
+     * @param string $announceUrl The 'AnnounceUrl' attribute lets you specify a
+     *                            URL for announcing something into a conference.
+     * @param string $announceMethod Specify GET or POST, defaults to POST
      */
     public function __construct($status = Values::NONE, $announceUrl = Values::NONE, $announceMethod = Values::NONE) {
         $this->options['status'] = $status;
@@ -178,9 +182,10 @@ class UpdateConferenceOptions extends Options {
     }
 
     /**
-     * The status
+     * Specifying `completed` will end the conference and kick all participants
      * 
-     * @param string $status The status
+     * @param string $status Specifying completed will end the conference and kick
+     *                       all participants
      * @return $this Fluent Builder
      */
     public function setStatus($status) {
@@ -189,9 +194,10 @@ class UpdateConferenceOptions extends Options {
     }
 
     /**
-     * The announce_url
+     * The 'AnnounceUrl' attribute lets you specify a URL for announcing something into a conference. The URL may return an MP3, a WAV or a TwiML document with `<Play>` or `<Say>`.
      * 
-     * @param string $announceUrl The announce_url
+     * @param string $announceUrl The 'AnnounceUrl' attribute lets you specify a
+     *                            URL for announcing something into a conference.
      * @return $this Fluent Builder
      */
     public function setAnnounceUrl($announceUrl) {
@@ -200,9 +206,9 @@ class UpdateConferenceOptions extends Options {
     }
 
     /**
-     * The announce_method
+     * Specify GET or POST, defaults to POST
      * 
-     * @param string $announceMethod The announce_method
+     * @param string $announceMethod Specify GET or POST, defaults to POST
      * @return $this Fluent Builder
      */
     public function setAnnounceMethod($announceMethod) {

plugins/Twilio/Rest/Api/V2010/Account/ConferencePage.php

@@ -37,6 +37,7 @@ class ConnectAppContext extends InstanceContext {
      * Fetch a ConnectAppInstance
      * 
      * @return ConnectAppInstance Fetched ConnectAppInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -60,6 +61,7 @@ class ConnectAppContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return ConnectAppInstance Updated ConnectAppInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/ConnectAppInstance.php

@@ -82,6 +82,7 @@ class ConnectAppInstance extends InstanceResource {
      * Fetch a ConnectAppInstance
      * 
      * @return ConnectAppInstance Fetched ConnectAppInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -92,6 +93,7 @@ class ConnectAppInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return ConnectAppInstance Updated ConnectAppInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);

plugins/Twilio/Rest/Api/V2010/Account/ConnectAppList.php

@@ -83,7 +83,7 @@ class UpdateConnectAppOptions extends Options {
     }
 
     /**
-     * The HTTP method to be used when making a request to the `DeauthorizeCallbackUrl`.
+     * The HTTP method to be used when making a request to the `DeauthorizeCallbackUrl`. Either `GET` or `POST`.
      * 
      * @param string $deauthorizeCallbackMethod HTTP method Twilio WIll use making
      *                                          requests to the url
@@ -118,7 +118,7 @@ class UpdateConnectAppOptions extends Options {
     }
 
     /**
-     * A human readable name for the Connect App.
+     * A human readable description of the Connect App, with maximum length 64 characters.
      * 
      * @param string $friendlyName A human readable name for the Connect App.
      * @return $this Fluent Builder
@@ -140,7 +140,7 @@ class UpdateConnectAppOptions extends Options {
     }
 
     /**
-     * The set of permissions that your ConnectApp requests.
+     * A comma-separated list of permssions you will request from users of this ConnectApp.  Valid permssions are `get-all` or `post-all`.
      * 
      * @param string $permissions The set of permissions that your ConnectApp
      *                            requests.

plugins/Twilio/Rest/Api/V2010/Account/ConnectAppPage.php

@@ -45,6 +45,7 @@ class AssignedAddOnExtensionContext extends InstanceContext {
      * Fetch a AssignedAddOnExtensionInstance
      * 
      * @return AssignedAddOnExtensionInstance Fetched AssignedAddOnExtensionInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/AssignedAddOn/AssignedAddOnExtensionInstance.php

@@ -89,6 +89,7 @@ class AssignedAddOnExtensionInstance extends InstanceResource {
      * Fetch a AssignedAddOnExtensionInstance
      * 
      * @return AssignedAddOnExtensionInstance Fetched AssignedAddOnExtensionInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/AssignedAddOn/AssignedAddOnExtensionList.php

@@ -46,6 +46,7 @@ class AssignedAddOnContext extends InstanceContext {
      * Fetch a AssignedAddOnInstance
      * 
      * @return AssignedAddOnInstance Fetched AssignedAddOnInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -69,6 +70,7 @@ class AssignedAddOnContext extends InstanceContext {
      * Deletes the AssignedAddOnInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/AssignedAddOnInstance.php

@@ -92,6 +92,7 @@ class AssignedAddOnInstance extends InstanceResource {
      * Fetch a AssignedAddOnInstance
      * 
      * @return AssignedAddOnInstance Fetched AssignedAddOnInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -101,6 +102,7 @@ class AssignedAddOnInstance extends InstanceResource {
      * Deletes the AssignedAddOnInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/AssignedAddOnList.php

@@ -126,6 +126,7 @@ class AssignedAddOnList extends ListResource {
      * @param string $installedAddOnSid A string that uniquely identifies the
      *                                  Add-on installation
      * @return AssignedAddOnInstance Newly created AssignedAddOnInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($installedAddOnSid) {
         $data = Values::of(array('InstalledAddOnSid' => $installedAddOnSid, ));

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/AssignedAddOnPage.php

@@ -129,9 +129,10 @@ class LocalList extends ListResource {
     /**
      * Create a new LocalInstance
      * 
-     * @param string $phoneNumber The phone_number
+     * @param string $phoneNumber The phone number you want to purchase.
      * @param array|Options $options Optional Arguments
      * @return LocalInstance Newly created LocalInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($phoneNumber, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/LocalOptions.php

@@ -14,10 +14,13 @@ use Twilio\Values;
 
 abstract class LocalOptions {
     /**
-     * @param boolean $beta The beta
-     * @param string $friendlyName The friendly_name
-     * @param string $phoneNumber The phone_number
-     * @param string $origin The origin
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $friendlyName Only show the incoming phone number resources
+     *                             with friendly names that exactly match this name.
+     * @param string $phoneNumber Only show the incoming phone number resources
+     *                            that match this pattern.
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      * @return ReadLocalOptions Options builder
      */
     public static function read($beta = Values::NONE, $friendlyName = Values::NONE, $phoneNumber = Values::NONE, $origin = Values::NONE) {
@@ -25,23 +28,43 @@ abstract class LocalOptions {
     }
 
     /**
-     * @param string $apiVersion The api_version
-     * @param string $friendlyName The friendly_name
-     * @param string $smsApplicationSid The sms_application_sid
-     * @param string $smsFallbackMethod The sms_fallback_method
-     * @param string $smsFallbackUrl The sms_fallback_url
-     * @param string $smsMethod The sms_method
-     * @param string $smsUrl The sms_url
-     * @param string $statusCallback The status_callback
-     * @param string $statusCallbackMethod The status_callback_method
-     * @param string $voiceApplicationSid The voice_application_sid
-     * @param boolean $voiceCallerIdLookup The voice_caller_id_lookup
-     * @param string $voiceFallbackMethod The voice_fallback_method
-     * @param string $voiceFallbackUrl The voice_fallback_url
-     * @param string $voiceMethod The voice_method
-     * @param string $voiceUrl The voice_url
+     * @param string $apiVersion The Twilio REST API version to use for incoming
+     *                           calls made to this number.
+     * @param string $friendlyName A human readable description of the new incoming
+     *                             phone number.
+     * @param string $smsApplicationSid The 34 character sid of the application
+     *                                  Twilio should use to handle SMSs sent to
+     *                                  the new number.
+     * @param string $smsFallbackMethod The HTTP method that should be used to
+     *                                  request the SmsFallbackUrl.
+     * @param string $smsFallbackUrl A URL that Twilio will request if an error
+     *                               occurs requesting or executing the TwiML
+     *                               defined by SmsUrl.
+     * @param string $smsMethod The HTTP method that should be used to request the
+     *                          SmsUrl.
+     * @param string $smsUrl The URL that Twilio should request when somebody sends
+     *                       an SMS to the phone number.
+     * @param string $statusCallback The URL that Twilio will request to pass
+     *                               status parameters to your application.
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
+     * @param string $voiceApplicationSid The 34 character sid of the application
+     *                                    Twilio should use to handle phone calls
+     *                                    to the new number.
+     * @param boolean $voiceCallerIdLookup Do a lookup of a caller's name from the
+     *                                     CNAM database and post it to your app.
+     * @param string $voiceFallbackMethod The HTTP method that should be used to
+     *                                    request the VoiceFallbackUrl.
+     * @param string $voiceFallbackUrl A URL that Twilio will request if an error
+     *                                 occurs requesting or executing the TwiML at
+     *                                 Url.
+     * @param string $voiceMethod The HTTP method that should be used to request
+     *                            the VoiceUrl.
+     * @param string $voiceUrl The URL that Twilio should request when somebody
+     *                         dials the new phone number.
      * @param string $identitySid The identity_sid
-     * @param string $addressSid The address_sid
+     * @param string $addressSid The 34 character sid of the address Twilio should
+     *                           associate with the number.
      * @return CreateLocalOptions Options builder
      */
     public static function create($apiVersion = Values::NONE, $friendlyName = Values::NONE, $smsApplicationSid = Values::NONE, $smsFallbackMethod = Values::NONE, $smsFallbackUrl = Values::NONE, $smsMethod = Values::NONE, $smsUrl = Values::NONE, $statusCallback = Values::NONE, $statusCallbackMethod = Values::NONE, $voiceApplicationSid = Values::NONE, $voiceCallerIdLookup = Values::NONE, $voiceFallbackMethod = Values::NONE, $voiceFallbackUrl = Values::NONE, $voiceMethod = Values::NONE, $voiceUrl = Values::NONE, $identitySid = Values::NONE, $addressSid = Values::NONE) {
@@ -51,10 +74,13 @@ abstract class LocalOptions {
 
 class ReadLocalOptions extends Options {
     /**
-     * @param boolean $beta The beta
-     * @param string $friendlyName The friendly_name
-     * @param string $phoneNumber The phone_number
-     * @param string $origin The origin
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $friendlyName Only show the incoming phone number resources
+     *                             with friendly names that exactly match this name.
+     * @param string $phoneNumber Only show the incoming phone number resources
+     *                            that match this pattern.
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      */
     public function __construct($beta = Values::NONE, $friendlyName = Values::NONE, $phoneNumber = Values::NONE, $origin = Values::NONE) {
         $this->options['beta'] = $beta;
@@ -64,9 +90,9 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The beta
+     * Include phone numbers new to the Twilio platform. Possible values are either `true` or `false`. Default is `true`.
      * 
-     * @param boolean $beta The beta
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
      * @return $this Fluent Builder
      */
     public function setBeta($beta) {
@@ -75,9 +101,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The friendly_name
+     * Only show the incoming phone number resources with friendly names that exactly match this name.
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName Only show the incoming phone number resources
+     *                             with friendly names that exactly match this name.
      * @return $this Fluent Builder
      */
     public function setFriendlyName($friendlyName) {
@@ -86,9 +113,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The phone_number
+     * Only show the incoming phone number resources that match this pattern. You can specify partial numbers and use '*' as a wildcard for any digit.
      * 
-     * @param string $phoneNumber The phone_number
+     * @param string $phoneNumber Only show the incoming phone number resources
+     *                            that match this pattern.
      * @return $this Fluent Builder
      */
     public function setPhoneNumber($phoneNumber) {
@@ -97,9 +125,10 @@ class ReadLocalOptions extends Options {
     }
 
     /**
-     * The origin
+     * Include phone numbers based on the origin, by default, phone numbers of all origin are included. Possible values are either `twilio` or `hosted`.
      * 
-     * @param string $origin The origin
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      * @return $this Fluent Builder
      */
     public function setOrigin($origin) {
@@ -125,23 +154,43 @@ class ReadLocalOptions extends Options {
 
 class CreateLocalOptions extends Options {
     /**
-     * @param string $apiVersion The api_version
-     * @param string $friendlyName The friendly_name
-     * @param string $smsApplicationSid The sms_application_sid
-     * @param string $smsFallbackMethod The sms_fallback_method
-     * @param string $smsFallbackUrl The sms_fallback_url
-     * @param string $smsMethod The sms_method
-     * @param string $smsUrl The sms_url
-     * @param string $statusCallback The status_callback
-     * @param string $statusCallbackMethod The status_callback_method
-     * @param string $voiceApplicationSid The voice_application_sid
-     * @param boolean $voiceCallerIdLookup The voice_caller_id_lookup
-     * @param string $voiceFallbackMethod The voice_fallback_method
-     * @param string $voiceFallbackUrl The voice_fallback_url
-     * @param string $voiceMethod The voice_method
-     * @param string $voiceUrl The voice_url
+     * @param string $apiVersion The Twilio REST API version to use for incoming
+     *                           calls made to this number.
+     * @param string $friendlyName A human readable description of the new incoming
+     *                             phone number.
+     * @param string $smsApplicationSid The 34 character sid of the application
+     *                                  Twilio should use to handle SMSs sent to
+     *                                  the new number.
+     * @param string $smsFallbackMethod The HTTP method that should be used to
+     *                                  request the SmsFallbackUrl.
+     * @param string $smsFallbackUrl A URL that Twilio will request if an error
+     *                               occurs requesting or executing the TwiML
+     *                               defined by SmsUrl.
+     * @param string $smsMethod The HTTP method that should be used to request the
+     *                          SmsUrl.
+     * @param string $smsUrl The URL that Twilio should request when somebody sends
+     *                       an SMS to the phone number.
+     * @param string $statusCallback The URL that Twilio will request to pass
+     *                               status parameters to your application.
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
+     * @param string $voiceApplicationSid The 34 character sid of the application
+     *                                    Twilio should use to handle phone calls
+     *                                    to the new number.
+     * @param boolean $voiceCallerIdLookup Do a lookup of a caller's name from the
+     *                                     CNAM database and post it to your app.
+     * @param string $voiceFallbackMethod The HTTP method that should be used to
+     *                                    request the VoiceFallbackUrl.
+     * @param string $voiceFallbackUrl A URL that Twilio will request if an error
+     *                                 occurs requesting or executing the TwiML at
+     *                                 Url.
+     * @param string $voiceMethod The HTTP method that should be used to request
+     *                            the VoiceUrl.
+     * @param string $voiceUrl The URL that Twilio should request when somebody
+     *                         dials the new phone number.
      * @param string $identitySid The identity_sid
-     * @param string $addressSid The address_sid
+     * @param string $addressSid The 34 character sid of the address Twilio should
+     *                           associate with the number.
      */
     public function __construct($apiVersion = Values::NONE, $friendlyName = Values::NONE, $smsApplicationSid = Values::NONE, $smsFallbackMethod = Values::NONE, $smsFallbackUrl = Values::NONE, $smsMethod = Values::NONE, $smsUrl = Values::NONE, $statusCallback = Values::NONE, $statusCallbackMethod = Values::NONE, $voiceApplicationSid = Values::NONE, $voiceCallerIdLookup = Values::NONE, $voiceFallbackMethod = Values::NONE, $voiceFallbackUrl = Values::NONE, $voiceMethod = Values::NONE, $voiceUrl = Values::NONE, $identitySid = Values::NONE, $addressSid = Values::NONE) {
         $this->options['apiVersion'] = $apiVersion;
@@ -164,9 +213,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The api_version
+     * The Twilio REST API version to use for incoming calls made to this number. If omitted, uses `2010-04-01`.
      * 
-     * @param string $apiVersion The api_version
+     * @param string $apiVersion The Twilio REST API version to use for incoming
+     *                           calls made to this number.
      * @return $this Fluent Builder
      */
     public function setApiVersion($apiVersion) {
@@ -175,9 +225,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The friendly_name
+     * A human readable description of the new incoming phone number. Maximum 64 characters. Defaults to a formatted version of the number.
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A human readable description of the new incoming
+     *                             phone number.
      * @return $this Fluent Builder
      */
     public function setFriendlyName($friendlyName) {
@@ -186,9 +237,11 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The sms_application_sid
+     * The 34 character sid of the application Twilio should use to handle SMSs sent to the new number. If a `SmsApplicationSid` is present, Twilio will ignore all of the SMS urls above and use those set on the application.
      * 
-     * @param string $smsApplicationSid The sms_application_sid
+     * @param string $smsApplicationSid The 34 character sid of the application
+     *                                  Twilio should use to handle SMSs sent to
+     *                                  the new number.
      * @return $this Fluent Builder
      */
     public function setSmsApplicationSid($smsApplicationSid) {
@@ -197,9 +250,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The sms_fallback_method
+     * The HTTP method that should be used to request the `SmsFallbackUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $smsFallbackMethod The sms_fallback_method
+     * @param string $smsFallbackMethod The HTTP method that should be used to
+     *                                  request the SmsFallbackUrl.
      * @return $this Fluent Builder
      */
     public function setSmsFallbackMethod($smsFallbackMethod) {
@@ -208,9 +262,11 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The sms_fallback_url
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML defined by `SmsUrl`.
      * 
-     * @param string $smsFallbackUrl The sms_fallback_url
+     * @param string $smsFallbackUrl A URL that Twilio will request if an error
+     *                               occurs requesting or executing the TwiML
+     *                               defined by SmsUrl.
      * @return $this Fluent Builder
      */
     public function setSmsFallbackUrl($smsFallbackUrl) {
@@ -219,9 +275,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The sms_method
+     * The HTTP method that should be used to request the `SmsUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $smsMethod The sms_method
+     * @param string $smsMethod The HTTP method that should be used to request the
+     *                          SmsUrl.
      * @return $this Fluent Builder
      */
     public function setSmsMethod($smsMethod) {
@@ -230,9 +287,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The sms_url
+     * The URL that Twilio should request when somebody sends an SMS to the phone number.
      * 
-     * @param string $smsUrl The sms_url
+     * @param string $smsUrl The URL that Twilio should request when somebody sends
+     *                       an SMS to the phone number.
      * @return $this Fluent Builder
      */
     public function setSmsUrl($smsUrl) {
@@ -241,9 +299,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The status_callback
+     * The URL that Twilio will request to pass status parameters (such as call ended) to your application.
      * 
-     * @param string $statusCallback The status_callback
+     * @param string $statusCallback The URL that Twilio will request to pass
+     *                               status parameters to your application.
      * @return $this Fluent Builder
      */
     public function setStatusCallback($statusCallback) {
@@ -252,9 +311,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The status_callback_method
+     * The HTTP method Twilio will use to make requests to the `StatusCallback` URL. Either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $statusCallbackMethod The status_callback_method
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
      * @return $this Fluent Builder
      */
     public function setStatusCallbackMethod($statusCallbackMethod) {
@@ -263,9 +323,11 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The voice_application_sid
+     * The 34 character sid of the application Twilio should use to handle phone calls to the new number. If a `VoiceApplicationSid` is present, Twilio will ignore all of the voice urls above and use those set on the application. Setting a `VoiceApplicationSid` will automatically delete your `TrunkSid` and vice versa.
      * 
-     * @param string $voiceApplicationSid The voice_application_sid
+     * @param string $voiceApplicationSid The 34 character sid of the application
+     *                                    Twilio should use to handle phone calls
+     *                                    to the new number.
      * @return $this Fluent Builder
      */
     public function setVoiceApplicationSid($voiceApplicationSid) {
@@ -274,9 +336,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The voice_caller_id_lookup
+     * Do a lookup of a caller's name from the CNAM database and post it to your app. Either `true` or `false`. Defaults to `false`.
      * 
-     * @param boolean $voiceCallerIdLookup The voice_caller_id_lookup
+     * @param boolean $voiceCallerIdLookup Do a lookup of a caller's name from the
+     *                                     CNAM database and post it to your app.
      * @return $this Fluent Builder
      */
     public function setVoiceCallerIdLookup($voiceCallerIdLookup) {
@@ -285,9 +348,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The voice_fallback_method
+     * The HTTP method that should be used to request the `VoiceFallbackUrl`. Either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $voiceFallbackMethod The voice_fallback_method
+     * @param string $voiceFallbackMethod The HTTP method that should be used to
+     *                                    request the VoiceFallbackUrl.
      * @return $this Fluent Builder
      */
     public function setVoiceFallbackMethod($voiceFallbackMethod) {
@@ -296,9 +360,11 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The voice_fallback_url
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML at `Url`.
      * 
-     * @param string $voiceFallbackUrl The voice_fallback_url
+     * @param string $voiceFallbackUrl A URL that Twilio will request if an error
+     *                                 occurs requesting or executing the TwiML at
+     *                                 Url.
      * @return $this Fluent Builder
      */
     public function setVoiceFallbackUrl($voiceFallbackUrl) {
@@ -307,9 +373,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The voice_method
+     * The HTTP method that should be used to request the `VoiceUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $voiceMethod The voice_method
+     * @param string $voiceMethod The HTTP method that should be used to request
+     *                            the VoiceUrl.
      * @return $this Fluent Builder
      */
     public function setVoiceMethod($voiceMethod) {
@@ -318,9 +385,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The voice_url
+     * The URL that Twilio should request when somebody dials the new phone number. The VoiceURL will  no longer be used if a `VoiceApplicationSid` or a `TrunkSid` is set.
      * 
-     * @param string $voiceUrl The voice_url
+     * @param string $voiceUrl The URL that Twilio should request when somebody
+     *                         dials the new phone number.
      * @return $this Fluent Builder
      */
     public function setVoiceUrl($voiceUrl) {
@@ -340,9 +408,10 @@ class CreateLocalOptions extends Options {
     }
 
     /**
-     * The address_sid
+     * The 34 character sid of the address Twilio should associate with the number.
      * 
-     * @param string $addressSid The address_sid
+     * @param string $addressSid The 34 character sid of the address Twilio should
+     *                           associate with the number.
      * @return $this Fluent Builder
      */
     public function setAddressSid($addressSid) {

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/LocalPage.php

@@ -129,9 +129,10 @@ class MobileList extends ListResource {
     /**
      * Create a new MobileInstance
      * 
-     * @param string $phoneNumber The phone_number
+     * @param string $phoneNumber The phone number you want to purchase.
      * @param array|Options $options Optional Arguments
      * @return MobileInstance Newly created MobileInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($phoneNumber, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/MobileOptions.php

@@ -14,10 +14,13 @@ use Twilio\Values;
 
 abstract class MobileOptions {
     /**
-     * @param boolean $beta The beta
-     * @param string $friendlyName The friendly_name
-     * @param string $phoneNumber The phone_number
-     * @param string $origin The origin
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $friendlyName Only show the incoming phone number resources
+     *                             with friendly names that exactly match this name.
+     * @param string $phoneNumber Only show the incoming phone number resources
+     *                            that match this pattern.
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      * @return ReadMobileOptions Options builder
      */
     public static function read($beta = Values::NONE, $friendlyName = Values::NONE, $phoneNumber = Values::NONE, $origin = Values::NONE) {
@@ -25,23 +28,43 @@ abstract class MobileOptions {
     }
 
     /**
-     * @param string $apiVersion The api_version
-     * @param string $friendlyName The friendly_name
-     * @param string $smsApplicationSid The sms_application_sid
-     * @param string $smsFallbackMethod The sms_fallback_method
-     * @param string $smsFallbackUrl The sms_fallback_url
-     * @param string $smsMethod The sms_method
-     * @param string $smsUrl The sms_url
-     * @param string $statusCallback The status_callback
-     * @param string $statusCallbackMethod The status_callback_method
-     * @param string $voiceApplicationSid The voice_application_sid
-     * @param boolean $voiceCallerIdLookup The voice_caller_id_lookup
-     * @param string $voiceFallbackMethod The voice_fallback_method
-     * @param string $voiceFallbackUrl The voice_fallback_url
-     * @param string $voiceMethod The voice_method
-     * @param string $voiceUrl The voice_url
+     * @param string $apiVersion The Twilio REST API version to use for incoming
+     *                           calls made to this number.
+     * @param string $friendlyName A human readable description of the new incoming
+     *                             phone number.
+     * @param string $smsApplicationSid The 34 character sid of the application
+     *                                  Twilio should use to handle SMSs sent to
+     *                                  the new number.
+     * @param string $smsFallbackMethod The HTTP method that should be used to
+     *                                  request the SmsFallbackUrl.
+     * @param string $smsFallbackUrl A URL that Twilio will request if an error
+     *                               occurs requesting or executing the TwiML
+     *                               defined by SmsUrl.
+     * @param string $smsMethod The HTTP method that should be used to request the
+     *                          SmsUrl.
+     * @param string $smsUrl The URL that Twilio should request when somebody sends
+     *                       an SMS to the phone number.
+     * @param string $statusCallback The URL that Twilio will request to pass
+     *                               status parameters to your application.
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
+     * @param string $voiceApplicationSid The 34 character sid of the application
+     *                                    Twilio should use to handle phone calls
+     *                                    to the new number.
+     * @param boolean $voiceCallerIdLookup Do a lookup of a caller's name from the
+     *                                     CNAM database and post it to your app.
+     * @param string $voiceFallbackMethod The HTTP method that should be used to
+     *                                    request the VoiceFallbackUrl.
+     * @param string $voiceFallbackUrl A URL that Twilio will request if an error
+     *                                 occurs requesting or executing the TwiML at
+     *                                 Url.
+     * @param string $voiceMethod The HTTP method that should be used to request
+     *                            the VoiceUrl.
+     * @param string $voiceUrl The URL that Twilio should request when somebody
+     *                         dials the new phone number.
      * @param string $identitySid The identity_sid
-     * @param string $addressSid The address_sid
+     * @param string $addressSid The 34 character sid of the address Twilio should
+     *                           associate with the number.
      * @return CreateMobileOptions Options builder
      */
     public static function create($apiVersion = Values::NONE, $friendlyName = Values::NONE, $smsApplicationSid = Values::NONE, $smsFallbackMethod = Values::NONE, $smsFallbackUrl = Values::NONE, $smsMethod = Values::NONE, $smsUrl = Values::NONE, $statusCallback = Values::NONE, $statusCallbackMethod = Values::NONE, $voiceApplicationSid = Values::NONE, $voiceCallerIdLookup = Values::NONE, $voiceFallbackMethod = Values::NONE, $voiceFallbackUrl = Values::NONE, $voiceMethod = Values::NONE, $voiceUrl = Values::NONE, $identitySid = Values::NONE, $addressSid = Values::NONE) {
@@ -51,10 +74,13 @@ abstract class MobileOptions {
 
 class ReadMobileOptions extends Options {
     /**
-     * @param boolean $beta The beta
-     * @param string $friendlyName The friendly_name
-     * @param string $phoneNumber The phone_number
-     * @param string $origin The origin
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $friendlyName Only show the incoming phone number resources
+     *                             with friendly names that exactly match this name.
+     * @param string $phoneNumber Only show the incoming phone number resources
+     *                            that match this pattern.
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      */
     public function __construct($beta = Values::NONE, $friendlyName = Values::NONE, $phoneNumber = Values::NONE, $origin = Values::NONE) {
         $this->options['beta'] = $beta;
@@ -64,9 +90,9 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The beta
+     * Include phone numbers new to the Twilio platform. Possible values are either `true` or `false`. Default is `true`.
      * 
-     * @param boolean $beta The beta
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
      * @return $this Fluent Builder
      */
     public function setBeta($beta) {
@@ -75,9 +101,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The friendly_name
+     * Only show the incoming phone number resources with friendly names that exactly match this name.
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName Only show the incoming phone number resources
+     *                             with friendly names that exactly match this name.
      * @return $this Fluent Builder
      */
     public function setFriendlyName($friendlyName) {
@@ -86,9 +113,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The phone_number
+     * Only show the incoming phone number resources that match this pattern. You can specify partial numbers and use '*' as a wildcard for any digit.
      * 
-     * @param string $phoneNumber The phone_number
+     * @param string $phoneNumber Only show the incoming phone number resources
+     *                            that match this pattern.
      * @return $this Fluent Builder
      */
     public function setPhoneNumber($phoneNumber) {
@@ -97,9 +125,10 @@ class ReadMobileOptions extends Options {
     }
 
     /**
-     * The origin
+     * Include phone numbers based on the origin, by default, phone numbers of all origin are included. Possible values are either `twilio` or `hosted`.
      * 
-     * @param string $origin The origin
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      * @return $this Fluent Builder
      */
     public function setOrigin($origin) {
@@ -125,23 +154,43 @@ class ReadMobileOptions extends Options {
 
 class CreateMobileOptions extends Options {
     /**
-     * @param string $apiVersion The api_version
-     * @param string $friendlyName The friendly_name
-     * @param string $smsApplicationSid The sms_application_sid
-     * @param string $smsFallbackMethod The sms_fallback_method
-     * @param string $smsFallbackUrl The sms_fallback_url
-     * @param string $smsMethod The sms_method
-     * @param string $smsUrl The sms_url
-     * @param string $statusCallback The status_callback
-     * @param string $statusCallbackMethod The status_callback_method
-     * @param string $voiceApplicationSid The voice_application_sid
-     * @param boolean $voiceCallerIdLookup The voice_caller_id_lookup
-     * @param string $voiceFallbackMethod The voice_fallback_method
-     * @param string $voiceFallbackUrl The voice_fallback_url
-     * @param string $voiceMethod The voice_method
-     * @param string $voiceUrl The voice_url
+     * @param string $apiVersion The Twilio REST API version to use for incoming
+     *                           calls made to this number.
+     * @param string $friendlyName A human readable description of the new incoming
+     *                             phone number.
+     * @param string $smsApplicationSid The 34 character sid of the application
+     *                                  Twilio should use to handle SMSs sent to
+     *                                  the new number.
+     * @param string $smsFallbackMethod The HTTP method that should be used to
+     *                                  request the SmsFallbackUrl.
+     * @param string $smsFallbackUrl A URL that Twilio will request if an error
+     *                               occurs requesting or executing the TwiML
+     *                               defined by SmsUrl.
+     * @param string $smsMethod The HTTP method that should be used to request the
+     *                          SmsUrl.
+     * @param string $smsUrl The URL that Twilio should request when somebody sends
+     *                       an SMS to the phone number.
+     * @param string $statusCallback The URL that Twilio will request to pass
+     *                               status parameters to your application.
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
+     * @param string $voiceApplicationSid The 34 character sid of the application
+     *                                    Twilio should use to handle phone calls
+     *                                    to the new number.
+     * @param boolean $voiceCallerIdLookup Do a lookup of a caller's name from the
+     *                                     CNAM database and post it to your app.
+     * @param string $voiceFallbackMethod The HTTP method that should be used to
+     *                                    request the VoiceFallbackUrl.
+     * @param string $voiceFallbackUrl A URL that Twilio will request if an error
+     *                                 occurs requesting or executing the TwiML at
+     *                                 Url.
+     * @param string $voiceMethod The HTTP method that should be used to request
+     *                            the VoiceUrl.
+     * @param string $voiceUrl The URL that Twilio should request when somebody
+     *                         dials the new phone number.
      * @param string $identitySid The identity_sid
-     * @param string $addressSid The address_sid
+     * @param string $addressSid The 34 character sid of the address Twilio should
+     *                           associate with the number.
      */
     public function __construct($apiVersion = Values::NONE, $friendlyName = Values::NONE, $smsApplicationSid = Values::NONE, $smsFallbackMethod = Values::NONE, $smsFallbackUrl = Values::NONE, $smsMethod = Values::NONE, $smsUrl = Values::NONE, $statusCallback = Values::NONE, $statusCallbackMethod = Values::NONE, $voiceApplicationSid = Values::NONE, $voiceCallerIdLookup = Values::NONE, $voiceFallbackMethod = Values::NONE, $voiceFallbackUrl = Values::NONE, $voiceMethod = Values::NONE, $voiceUrl = Values::NONE, $identitySid = Values::NONE, $addressSid = Values::NONE) {
         $this->options['apiVersion'] = $apiVersion;
@@ -164,9 +213,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The api_version
+     * The Twilio REST API version to use for incoming calls made to this number. If omitted, uses `2010-04-01`.
      * 
-     * @param string $apiVersion The api_version
+     * @param string $apiVersion The Twilio REST API version to use for incoming
+     *                           calls made to this number.
      * @return $this Fluent Builder
      */
     public function setApiVersion($apiVersion) {
@@ -175,9 +225,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The friendly_name
+     * A human readable description of the new incoming phone number. Maximum 64 characters. Defaults to a formatted version of the number.
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A human readable description of the new incoming
+     *                             phone number.
      * @return $this Fluent Builder
      */
     public function setFriendlyName($friendlyName) {
@@ -186,9 +237,11 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The sms_application_sid
+     * The 34 character sid of the application Twilio should use to handle SMSs sent to the new number. If a `SmsApplicationSid` is present, Twilio will ignore all of the SMS urls above and use those set on the application.
      * 
-     * @param string $smsApplicationSid The sms_application_sid
+     * @param string $smsApplicationSid The 34 character sid of the application
+     *                                  Twilio should use to handle SMSs sent to
+     *                                  the new number.
      * @return $this Fluent Builder
      */
     public function setSmsApplicationSid($smsApplicationSid) {
@@ -197,9 +250,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The sms_fallback_method
+     * The HTTP method that should be used to request the `SmsFallbackUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $smsFallbackMethod The sms_fallback_method
+     * @param string $smsFallbackMethod The HTTP method that should be used to
+     *                                  request the SmsFallbackUrl.
      * @return $this Fluent Builder
      */
     public function setSmsFallbackMethod($smsFallbackMethod) {
@@ -208,9 +262,11 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The sms_fallback_url
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML defined by `SmsUrl`.
      * 
-     * @param string $smsFallbackUrl The sms_fallback_url
+     * @param string $smsFallbackUrl A URL that Twilio will request if an error
+     *                               occurs requesting or executing the TwiML
+     *                               defined by SmsUrl.
      * @return $this Fluent Builder
      */
     public function setSmsFallbackUrl($smsFallbackUrl) {
@@ -219,9 +275,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The sms_method
+     * The HTTP method that should be used to request the `SmsUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $smsMethod The sms_method
+     * @param string $smsMethod The HTTP method that should be used to request the
+     *                          SmsUrl.
      * @return $this Fluent Builder
      */
     public function setSmsMethod($smsMethod) {
@@ -230,9 +287,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The sms_url
+     * The URL that Twilio should request when somebody sends an SMS to the phone number.
      * 
-     * @param string $smsUrl The sms_url
+     * @param string $smsUrl The URL that Twilio should request when somebody sends
+     *                       an SMS to the phone number.
      * @return $this Fluent Builder
      */
     public function setSmsUrl($smsUrl) {
@@ -241,9 +299,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The status_callback
+     * The URL that Twilio will request to pass status parameters (such as call ended) to your application.
      * 
-     * @param string $statusCallback The status_callback
+     * @param string $statusCallback The URL that Twilio will request to pass
+     *                               status parameters to your application.
      * @return $this Fluent Builder
      */
     public function setStatusCallback($statusCallback) {
@@ -252,9 +311,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The status_callback_method
+     * The HTTP method Twilio will use to make requests to the `StatusCallback` URL. Either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $statusCallbackMethod The status_callback_method
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
      * @return $this Fluent Builder
      */
     public function setStatusCallbackMethod($statusCallbackMethod) {
@@ -263,9 +323,11 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The voice_application_sid
+     * The 34 character sid of the application Twilio should use to handle phone calls to the new number. If a `VoiceApplicationSid` is present, Twilio will ignore all of the voice urls above and use those set on the application. Setting a `VoiceApplicationSid` will automatically delete your `TrunkSid` and vice versa.
      * 
-     * @param string $voiceApplicationSid The voice_application_sid
+     * @param string $voiceApplicationSid The 34 character sid of the application
+     *                                    Twilio should use to handle phone calls
+     *                                    to the new number.
      * @return $this Fluent Builder
      */
     public function setVoiceApplicationSid($voiceApplicationSid) {
@@ -274,9 +336,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The voice_caller_id_lookup
+     * Do a lookup of a caller's name from the CNAM database and post it to your app. Either `true` or `false`. Defaults to `false`.
      * 
-     * @param boolean $voiceCallerIdLookup The voice_caller_id_lookup
+     * @param boolean $voiceCallerIdLookup Do a lookup of a caller's name from the
+     *                                     CNAM database and post it to your app.
      * @return $this Fluent Builder
      */
     public function setVoiceCallerIdLookup($voiceCallerIdLookup) {
@@ -285,9 +348,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The voice_fallback_method
+     * The HTTP method that should be used to request the `VoiceFallbackUrl`. Either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $voiceFallbackMethod The voice_fallback_method
+     * @param string $voiceFallbackMethod The HTTP method that should be used to
+     *                                    request the VoiceFallbackUrl.
      * @return $this Fluent Builder
      */
     public function setVoiceFallbackMethod($voiceFallbackMethod) {
@@ -296,9 +360,11 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The voice_fallback_url
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML at `Url`.
      * 
-     * @param string $voiceFallbackUrl The voice_fallback_url
+     * @param string $voiceFallbackUrl A URL that Twilio will request if an error
+     *                                 occurs requesting or executing the TwiML at
+     *                                 Url.
      * @return $this Fluent Builder
      */
     public function setVoiceFallbackUrl($voiceFallbackUrl) {
@@ -307,9 +373,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The voice_method
+     * The HTTP method that should be used to request the `VoiceUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $voiceMethod The voice_method
+     * @param string $voiceMethod The HTTP method that should be used to request
+     *                            the VoiceUrl.
      * @return $this Fluent Builder
      */
     public function setVoiceMethod($voiceMethod) {
@@ -318,9 +385,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The voice_url
+     * The URL that Twilio should request when somebody dials the new phone number. The VoiceURL will  no longer be used if a `VoiceApplicationSid` or a `TrunkSid` is set.
      * 
-     * @param string $voiceUrl The voice_url
+     * @param string $voiceUrl The URL that Twilio should request when somebody
+     *                         dials the new phone number.
      * @return $this Fluent Builder
      */
     public function setVoiceUrl($voiceUrl) {
@@ -340,9 +408,10 @@ class CreateMobileOptions extends Options {
     }
 
     /**
-     * The address_sid
+     * The 34 character sid of the address Twilio should associate with the number.
      * 
-     * @param string $addressSid The address_sid
+     * @param string $addressSid The 34 character sid of the address Twilio should
+     *                           associate with the number.
      * @return $this Fluent Builder
      */
     public function setAddressSid($addressSid) {

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/MobilePage.php

@@ -129,9 +129,10 @@ class TollFreeList extends ListResource {
     /**
      * Create a new TollFreeInstance
      * 
-     * @param string $phoneNumber The phone_number
+     * @param string $phoneNumber The phone number you want to purchase.
      * @param array|Options $options Optional Arguments
      * @return TollFreeInstance Newly created TollFreeInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($phoneNumber, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/TollFreeOptions.php

@@ -14,10 +14,13 @@ use Twilio\Values;
 
 abstract class TollFreeOptions {
     /**
-     * @param boolean $beta The beta
-     * @param string $friendlyName The friendly_name
-     * @param string $phoneNumber The phone_number
-     * @param string $origin The origin
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $friendlyName Only show the incoming phone number resources
+     *                             with friendly names that exactly match this name.
+     * @param string $phoneNumber Only show the incoming phone number resources
+     *                            that match this pattern.
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      * @return ReadTollFreeOptions Options builder
      */
     public static function read($beta = Values::NONE, $friendlyName = Values::NONE, $phoneNumber = Values::NONE, $origin = Values::NONE) {
@@ -25,23 +28,43 @@ abstract class TollFreeOptions {
     }
 
     /**
-     * @param string $apiVersion The api_version
-     * @param string $friendlyName The friendly_name
-     * @param string $smsApplicationSid The sms_application_sid
-     * @param string $smsFallbackMethod The sms_fallback_method
-     * @param string $smsFallbackUrl The sms_fallback_url
-     * @param string $smsMethod The sms_method
-     * @param string $smsUrl The sms_url
-     * @param string $statusCallback The status_callback
-     * @param string $statusCallbackMethod The status_callback_method
-     * @param string $voiceApplicationSid The voice_application_sid
-     * @param boolean $voiceCallerIdLookup The voice_caller_id_lookup
-     * @param string $voiceFallbackMethod The voice_fallback_method
-     * @param string $voiceFallbackUrl The voice_fallback_url
-     * @param string $voiceMethod The voice_method
-     * @param string $voiceUrl The voice_url
+     * @param string $apiVersion The Twilio REST API version to use for incoming
+     *                           calls made to this number.
+     * @param string $friendlyName A human readable description of the new incoming
+     *                             phone number.
+     * @param string $smsApplicationSid The 34 character sid of the application
+     *                                  Twilio should use to handle SMSs sent to
+     *                                  the new number.
+     * @param string $smsFallbackMethod The HTTP method that should be used to
+     *                                  request the SmsFallbackUrl.
+     * @param string $smsFallbackUrl A URL that Twilio will request if an error
+     *                               occurs requesting or executing the TwiML
+     *                               defined by SmsUrl.
+     * @param string $smsMethod The HTTP method that should be used to request the
+     *                          SmsUrl.
+     * @param string $smsUrl The URL that Twilio should request when somebody sends
+     *                       an SMS to the phone number.
+     * @param string $statusCallback The URL that Twilio will request to pass
+     *                               status parameters to your application.
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
+     * @param string $voiceApplicationSid The 34 character sid of the application
+     *                                    Twilio should use to handle phone calls
+     *                                    to the new number.
+     * @param boolean $voiceCallerIdLookup Do a lookup of a caller's name from the
+     *                                     CNAM database and post it to your app.
+     * @param string $voiceFallbackMethod The HTTP method that should be used to
+     *                                    request the VoiceFallbackUrl.
+     * @param string $voiceFallbackUrl A URL that Twilio will request if an error
+     *                                 occurs requesting or executing the TwiML at
+     *                                 Url.
+     * @param string $voiceMethod The HTTP method that should be used to request
+     *                            the VoiceUrl.
+     * @param string $voiceUrl The URL that Twilio should request when somebody
+     *                         dials the new phone number.
      * @param string $identitySid The identity_sid
-     * @param string $addressSid The address_sid
+     * @param string $addressSid The 34 character sid of the address Twilio should
+     *                           associate with the number.
      * @return CreateTollFreeOptions Options builder
      */
     public static function create($apiVersion = Values::NONE, $friendlyName = Values::NONE, $smsApplicationSid = Values::NONE, $smsFallbackMethod = Values::NONE, $smsFallbackUrl = Values::NONE, $smsMethod = Values::NONE, $smsUrl = Values::NONE, $statusCallback = Values::NONE, $statusCallbackMethod = Values::NONE, $voiceApplicationSid = Values::NONE, $voiceCallerIdLookup = Values::NONE, $voiceFallbackMethod = Values::NONE, $voiceFallbackUrl = Values::NONE, $voiceMethod = Values::NONE, $voiceUrl = Values::NONE, $identitySid = Values::NONE, $addressSid = Values::NONE) {
@@ -51,10 +74,13 @@ abstract class TollFreeOptions {
 
 class ReadTollFreeOptions extends Options {
     /**
-     * @param boolean $beta The beta
-     * @param string $friendlyName The friendly_name
-     * @param string $phoneNumber The phone_number
-     * @param string $origin The origin
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
+     * @param string $friendlyName Only show the incoming phone number resources
+     *                             with friendly names that exactly match this name.
+     * @param string $phoneNumber Only show the incoming phone number resources
+     *                            that match this pattern.
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      */
     public function __construct($beta = Values::NONE, $friendlyName = Values::NONE, $phoneNumber = Values::NONE, $origin = Values::NONE) {
         $this->options['beta'] = $beta;
@@ -64,9 +90,9 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The beta
+     * Include phone numbers new to the Twilio platform. Possible values are either `true` or `false`. Default is `true`.
      * 
-     * @param boolean $beta The beta
+     * @param boolean $beta Include phone numbers new to the Twilio platform.
      * @return $this Fluent Builder
      */
     public function setBeta($beta) {
@@ -75,9 +101,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The friendly_name
+     * Only show the incoming phone number resources with friendly names that exactly match this name.
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName Only show the incoming phone number resources
+     *                             with friendly names that exactly match this name.
      * @return $this Fluent Builder
      */
     public function setFriendlyName($friendlyName) {
@@ -86,9 +113,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The phone_number
+     * Only show the incoming phone number resources that match this pattern. You can specify partial numbers and use '*' as a wildcard for any digit.
      * 
-     * @param string $phoneNumber The phone_number
+     * @param string $phoneNumber Only show the incoming phone number resources
+     *                            that match this pattern.
      * @return $this Fluent Builder
      */
     public function setPhoneNumber($phoneNumber) {
@@ -97,9 +125,10 @@ class ReadTollFreeOptions extends Options {
     }
 
     /**
-     * The origin
+     * Include phone numbers based on the origin, by default, phone numbers of all origin are included. Possible values are either `twilio` or `hosted`.
      * 
-     * @param string $origin The origin
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      * @return $this Fluent Builder
      */
     public function setOrigin($origin) {
@@ -125,23 +154,43 @@ class ReadTollFreeOptions extends Options {
 
 class CreateTollFreeOptions extends Options {
     /**
-     * @param string $apiVersion The api_version
-     * @param string $friendlyName The friendly_name
-     * @param string $smsApplicationSid The sms_application_sid
-     * @param string $smsFallbackMethod The sms_fallback_method
-     * @param string $smsFallbackUrl The sms_fallback_url
-     * @param string $smsMethod The sms_method
-     * @param string $smsUrl The sms_url
-     * @param string $statusCallback The status_callback
-     * @param string $statusCallbackMethod The status_callback_method
-     * @param string $voiceApplicationSid The voice_application_sid
-     * @param boolean $voiceCallerIdLookup The voice_caller_id_lookup
-     * @param string $voiceFallbackMethod The voice_fallback_method
-     * @param string $voiceFallbackUrl The voice_fallback_url
-     * @param string $voiceMethod The voice_method
-     * @param string $voiceUrl The voice_url
+     * @param string $apiVersion The Twilio REST API version to use for incoming
+     *                           calls made to this number.
+     * @param string $friendlyName A human readable description of the new incoming
+     *                             phone number.
+     * @param string $smsApplicationSid The 34 character sid of the application
+     *                                  Twilio should use to handle SMSs sent to
+     *                                  the new number.
+     * @param string $smsFallbackMethod The HTTP method that should be used to
+     *                                  request the SmsFallbackUrl.
+     * @param string $smsFallbackUrl A URL that Twilio will request if an error
+     *                               occurs requesting or executing the TwiML
+     *                               defined by SmsUrl.
+     * @param string $smsMethod The HTTP method that should be used to request the
+     *                          SmsUrl.
+     * @param string $smsUrl The URL that Twilio should request when somebody sends
+     *                       an SMS to the phone number.
+     * @param string $statusCallback The URL that Twilio will request to pass
+     *                               status parameters to your application.
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
+     * @param string $voiceApplicationSid The 34 character sid of the application
+     *                                    Twilio should use to handle phone calls
+     *                                    to the new number.
+     * @param boolean $voiceCallerIdLookup Do a lookup of a caller's name from the
+     *                                     CNAM database and post it to your app.
+     * @param string $voiceFallbackMethod The HTTP method that should be used to
+     *                                    request the VoiceFallbackUrl.
+     * @param string $voiceFallbackUrl A URL that Twilio will request if an error
+     *                                 occurs requesting or executing the TwiML at
+     *                                 Url.
+     * @param string $voiceMethod The HTTP method that should be used to request
+     *                            the VoiceUrl.
+     * @param string $voiceUrl The URL that Twilio should request when somebody
+     *                         dials the new phone number.
      * @param string $identitySid The identity_sid
-     * @param string $addressSid The address_sid
+     * @param string $addressSid The 34 character sid of the address Twilio should
+     *                           associate with the number.
      */
     public function __construct($apiVersion = Values::NONE, $friendlyName = Values::NONE, $smsApplicationSid = Values::NONE, $smsFallbackMethod = Values::NONE, $smsFallbackUrl = Values::NONE, $smsMethod = Values::NONE, $smsUrl = Values::NONE, $statusCallback = Values::NONE, $statusCallbackMethod = Values::NONE, $voiceApplicationSid = Values::NONE, $voiceCallerIdLookup = Values::NONE, $voiceFallbackMethod = Values::NONE, $voiceFallbackUrl = Values::NONE, $voiceMethod = Values::NONE, $voiceUrl = Values::NONE, $identitySid = Values::NONE, $addressSid = Values::NONE) {
         $this->options['apiVersion'] = $apiVersion;
@@ -164,9 +213,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The api_version
+     * The Twilio REST API version to use for incoming calls made to this number. If omitted, uses `2010-04-01`.
      * 
-     * @param string $apiVersion The api_version
+     * @param string $apiVersion The Twilio REST API version to use for incoming
+     *                           calls made to this number.
      * @return $this Fluent Builder
      */
     public function setApiVersion($apiVersion) {
@@ -175,9 +225,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The friendly_name
+     * A human readable description of the new incoming phone number. Maximum 64 characters. Defaults to a formatted version of the number.
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A human readable description of the new incoming
+     *                             phone number.
      * @return $this Fluent Builder
      */
     public function setFriendlyName($friendlyName) {
@@ -186,9 +237,11 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The sms_application_sid
+     * The 34 character sid of the application Twilio should use to handle SMSs sent to the new number. If a `SmsApplicationSid` is present, Twilio will ignore all of the SMS urls above and use those set on the application.
      * 
-     * @param string $smsApplicationSid The sms_application_sid
+     * @param string $smsApplicationSid The 34 character sid of the application
+     *                                  Twilio should use to handle SMSs sent to
+     *                                  the new number.
      * @return $this Fluent Builder
      */
     public function setSmsApplicationSid($smsApplicationSid) {
@@ -197,9 +250,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The sms_fallback_method
+     * The HTTP method that should be used to request the `SmsFallbackUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $smsFallbackMethod The sms_fallback_method
+     * @param string $smsFallbackMethod The HTTP method that should be used to
+     *                                  request the SmsFallbackUrl.
      * @return $this Fluent Builder
      */
     public function setSmsFallbackMethod($smsFallbackMethod) {
@@ -208,9 +262,11 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The sms_fallback_url
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML defined by `SmsUrl`.
      * 
-     * @param string $smsFallbackUrl The sms_fallback_url
+     * @param string $smsFallbackUrl A URL that Twilio will request if an error
+     *                               occurs requesting or executing the TwiML
+     *                               defined by SmsUrl.
      * @return $this Fluent Builder
      */
     public function setSmsFallbackUrl($smsFallbackUrl) {
@@ -219,9 +275,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The sms_method
+     * The HTTP method that should be used to request the `SmsUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $smsMethod The sms_method
+     * @param string $smsMethod The HTTP method that should be used to request the
+     *                          SmsUrl.
      * @return $this Fluent Builder
      */
     public function setSmsMethod($smsMethod) {
@@ -230,9 +287,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The sms_url
+     * The URL that Twilio should request when somebody sends an SMS to the phone number.
      * 
-     * @param string $smsUrl The sms_url
+     * @param string $smsUrl The URL that Twilio should request when somebody sends
+     *                       an SMS to the phone number.
      * @return $this Fluent Builder
      */
     public function setSmsUrl($smsUrl) {
@@ -241,9 +299,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The status_callback
+     * The URL that Twilio will request to pass status parameters (such as call ended) to your application.
      * 
-     * @param string $statusCallback The status_callback
+     * @param string $statusCallback The URL that Twilio will request to pass
+     *                               status parameters to your application.
      * @return $this Fluent Builder
      */
     public function setStatusCallback($statusCallback) {
@@ -252,9 +311,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The status_callback_method
+     * The HTTP method Twilio will use to make requests to the `StatusCallback` URL. Either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $statusCallbackMethod The status_callback_method
+     * @param string $statusCallbackMethod The HTTP method Twilio will use to make
+     *                                     requests to the StatusCallback URL.
      * @return $this Fluent Builder
      */
     public function setStatusCallbackMethod($statusCallbackMethod) {
@@ -263,9 +323,11 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The voice_application_sid
+     * The 34 character sid of the application Twilio should use to handle phone calls to the new number. If a `VoiceApplicationSid` is present, Twilio will ignore all of the voice urls above and use those set on the application. Setting a `VoiceApplicationSid` will automatically delete your `TrunkSid` and vice versa.
      * 
-     * @param string $voiceApplicationSid The voice_application_sid
+     * @param string $voiceApplicationSid The 34 character sid of the application
+     *                                    Twilio should use to handle phone calls
+     *                                    to the new number.
      * @return $this Fluent Builder
      */
     public function setVoiceApplicationSid($voiceApplicationSid) {
@@ -274,9 +336,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The voice_caller_id_lookup
+     * Do a lookup of a caller's name from the CNAM database and post it to your app. Either `true` or `false`. Defaults to `false`.
      * 
-     * @param boolean $voiceCallerIdLookup The voice_caller_id_lookup
+     * @param boolean $voiceCallerIdLookup Do a lookup of a caller's name from the
+     *                                     CNAM database and post it to your app.
      * @return $this Fluent Builder
      */
     public function setVoiceCallerIdLookup($voiceCallerIdLookup) {
@@ -285,9 +348,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The voice_fallback_method
+     * The HTTP method that should be used to request the `VoiceFallbackUrl`. Either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $voiceFallbackMethod The voice_fallback_method
+     * @param string $voiceFallbackMethod The HTTP method that should be used to
+     *                                    request the VoiceFallbackUrl.
      * @return $this Fluent Builder
      */
     public function setVoiceFallbackMethod($voiceFallbackMethod) {
@@ -296,9 +360,11 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The voice_fallback_url
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML at `Url`.
      * 
-     * @param string $voiceFallbackUrl The voice_fallback_url
+     * @param string $voiceFallbackUrl A URL that Twilio will request if an error
+     *                                 occurs requesting or executing the TwiML at
+     *                                 Url.
      * @return $this Fluent Builder
      */
     public function setVoiceFallbackUrl($voiceFallbackUrl) {
@@ -307,9 +373,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The voice_method
+     * The HTTP method that should be used to request the `VoiceUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
-     * @param string $voiceMethod The voice_method
+     * @param string $voiceMethod The HTTP method that should be used to request
+     *                            the VoiceUrl.
      * @return $this Fluent Builder
      */
     public function setVoiceMethod($voiceMethod) {
@@ -318,9 +385,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The voice_url
+     * The URL that Twilio should request when somebody dials the new phone number. The VoiceURL will  no longer be used if a `VoiceApplicationSid` or a `TrunkSid` is set.
      * 
-     * @param string $voiceUrl The voice_url
+     * @param string $voiceUrl The URL that Twilio should request when somebody
+     *                         dials the new phone number.
      * @return $this Fluent Builder
      */
     public function setVoiceUrl($voiceUrl) {
@@ -340,9 +408,10 @@ class CreateTollFreeOptions extends Options {
     }
 
     /**
-     * The address_sid
+     * The 34 character sid of the address Twilio should associate with the number.
      * 
-     * @param string $addressSid The address_sid
+     * @param string $addressSid The 34 character sid of the address Twilio should
+     *                           associate with the number.
      * @return $this Fluent Builder
      */
     public function setAddressSid($addressSid) {

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumber/TollFreePage.php

@@ -46,6 +46,7 @@ class IncomingPhoneNumberContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return IncomingPhoneNumberInstance Updated IncomingPhoneNumberInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);
@@ -94,6 +95,7 @@ class IncomingPhoneNumberContext extends InstanceContext {
      * Fetch a IncomingPhoneNumberInstance
      * 
      * @return IncomingPhoneNumberInstance Fetched IncomingPhoneNumberInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -116,6 +118,7 @@ class IncomingPhoneNumberContext extends InstanceContext {
      * Deletes the IncomingPhoneNumberInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumberInstance.php

@@ -125,6 +125,7 @@ class IncomingPhoneNumberInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return IncomingPhoneNumberInstance Updated IncomingPhoneNumberInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);
@@ -134,6 +135,7 @@ class IncomingPhoneNumberInstance extends InstanceResource {
      * Fetch a IncomingPhoneNumberInstance
      * 
      * @return IncomingPhoneNumberInstance Fetched IncomingPhoneNumberInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -143,6 +145,7 @@ class IncomingPhoneNumberInstance extends InstanceResource {
      * Deletes the IncomingPhoneNumberInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumberList.php

@@ -145,6 +145,7 @@ class IncomingPhoneNumberList extends ListResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return IncomingPhoneNumberInstance Newly created IncomingPhoneNumberInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumberOptions.php

@@ -53,7 +53,8 @@ abstract class IncomingPhoneNumberOptions {
      * @param boolean $beta Include new phone numbers
      * @param string $friendlyName Filter by friendly name
      * @param string $phoneNumber Filter by incoming phone number
-     * @param string $origin The origin
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      * @return ReadIncomingPhoneNumberOptions Options builder
      */
     public static function read($beta = Values::NONE, $friendlyName = Values::NONE, $phoneNumber = Values::NONE, $origin = Values::NONE) {
@@ -155,7 +156,7 @@ class UpdateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The unique id of the Account to which you wish to transfer this phone number
+     * The unique 34 character id of the account to which you wish to transfer this phone number. See [Exchanging Numbers Between Subaccounts](https://www.twilio.com/docs/iam/api/subaccounts#exchanging-numbers).
      * 
      * @param string $accountSid The new owner of the phone number
      * @return $this Fluent Builder
@@ -166,7 +167,7 @@ class UpdateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * Calls to this phone number will start a new TwiML session with this API version.
+     * Calls to this phone number will start a new TwiML session with this API version. Either `2010-04-01` or `2008-08-01`.
      * 
      * @param string $apiVersion The Twilio REST API version to use
      * @return $this Fluent Builder
@@ -188,7 +189,7 @@ class UpdateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The 34 character sid of the application Twilio should use to handle SMSs sent to this number. If a `SmsApplicationSid` is present, Twilio will ignore all of the SMS urls above and use those set on the application.
+     * The 34 character sid of the application Twilio should use to handle SMSs sent to this number. If a `SmsApplicationSid` is present, Twilio will ignore all of the SMS urls above and use those set on the application instead.
      * 
      * @param string $smsApplicationSid Unique string that identifies the
      *                                  application
@@ -200,7 +201,7 @@ class UpdateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use when requesting the above URL. Either `GET` or `POST`.
+     * The HTTP method that should be used to request the `SmsFallbackUrl`. Either `GET` or `POST`.
      * 
      * @param string $smsFallbackMethod HTTP method used with sms fallback url
      * @return $this Fluent Builder
@@ -211,7 +212,7 @@ class UpdateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The URL that Twilio will request if an error occurs retrieving or executing the TwiML from `SmsUrl`.
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML defined by `SmsUrl`.
      * 
      * @param string $smsFallbackUrl URL Twilio will request if an error occurs in
      *                               executing TwiML
@@ -234,7 +235,7 @@ class UpdateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The URL Twilio will request when receiving an incoming SMS message to this number.
+     * The URL that Twilio should request when somebody sends an SMS to the new phone number.
      * 
      * @param string $smsUrl URL Twilio will request when receiving an SMS
      * @return $this Fluent Builder
@@ -268,7 +269,7 @@ class UpdateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The 34 character sid of the application Twilio should use to handle phone calls to this number. If a `VoiceApplicationSid` is present, Twilio will ignore all of the voice urls above and use those set on the application. Setting a `VoiceApplicationSid` will automatically delete your `TrunkSid` and vice versa.
+     * The 34 character sid of the application Twilio should use to handle phone calls to this number. If a `VoiceApplicationSid` is present, Twilio will ignore all of the voice urls above and use those set on the application instead. Setting a `VoiceApplicationSid` will automatically delete your `TrunkSid` and vice versa.
      * 
      * @param string $voiceApplicationSid The unique sid of the application to
      *                                    handle this number
@@ -302,7 +303,7 @@ class UpdateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The URL that Twilio will request if an error occurs retrieving or executing the TwiML requested by `Url`.
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML defined by `VoiceUrl`.
      * 
      * @param string $voiceFallbackUrl URL Twilio will request when an error occurs
      *                                 in TwiML
@@ -325,7 +326,7 @@ class UpdateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The URL Twilio will request when this phone number receives a call. The VoiceURL will  no longer be used if a `VoiceApplicationSid` or a `TrunkSid` is set.
+     * The URL that Twilio should request when somebody dials the phone number. The VoiceURL will  no longer be used if a `VoiceApplicationSid` or a `TrunkSid` is set.
      * 
      * @param string $voiceUrl URL Twilio will request when receiving a call
      * @return $this Fluent Builder
@@ -392,7 +393,7 @@ class UpdateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The 34 character sid of the address Twilio should use to associate with the number. Addresses are required in some regions to meet local regulations
+     * The 34 character sid of the address Twilio should associate with the number. If the number has address restrictions, only another address that satisfies the requirement can replace the existing one.
      * 
      * @param string $addressSid Unique string that identifies the address
      *                           associated with number
@@ -424,7 +425,8 @@ class ReadIncomingPhoneNumberOptions extends Options {
      * @param boolean $beta Include new phone numbers
      * @param string $friendlyName Filter by friendly name
      * @param string $phoneNumber Filter by incoming phone number
-     * @param string $origin The origin
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      */
     public function __construct($beta = Values::NONE, $friendlyName = Values::NONE, $phoneNumber = Values::NONE, $origin = Values::NONE) {
         $this->options['beta'] = $beta;
@@ -434,7 +436,7 @@ class ReadIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * Include phone numbers new to the Twilio platform
+     * Include phone numbers new to the Twilio platform. Possible values are either `true` or `false`. Default is `true`.
      * 
      * @param boolean $beta Include new phone numbers
      * @return $this Fluent Builder
@@ -445,7 +447,7 @@ class ReadIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * Only show the incoming phone number resources with friendly names that exactly match this name
+     * Only show the incoming phone number resources with friendly names that exactly match this name.
      * 
      * @param string $friendlyName Filter by friendly name
      * @return $this Fluent Builder
@@ -456,7 +458,7 @@ class ReadIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * Only show the incoming phone number resources that match this pattern
+     * Only show the incoming phone number resources that match this pattern. You can specify partial numbers and use '*' as a wildcard for any digit.
      * 
      * @param string $phoneNumber Filter by incoming phone number
      * @return $this Fluent Builder
@@ -467,9 +469,10 @@ class ReadIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The origin
+     * Include phone numbers based on the origin, by default, phone numbers of all origin are included. Possible values are either `twilio` or `hosted`.
      * 
-     * @param string $origin The origin
+     * @param string $origin Include phone numbers based on the origin, by default,
+     *                       phone numbers of all origin are included.
      * @return $this Fluent Builder
      */
     public function setOrigin($origin) {
@@ -551,7 +554,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The phone number to purchase. e.g., +16175551212 (E.164 format)
+     * The phone number you want to purchase. The number should be formatted starting with a '+' followed by the country code and the number in [E.164](http://en.wikipedia.org/wiki/E.164) format e.g., '+15105555555'. **You must include either this or an `AreaCode` parameter to have your POST succeed.**
      * 
      * @param string $phoneNumber The phone number
      * @return $this Fluent Builder
@@ -562,7 +565,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The desired area code for the new phone number. Any three digit US or Canada rea code is valid
+     * The desired area code for your new incoming phone number. Any three digit, US or Canada area code is valid. Twilio will provision a random phone number within this area code for you. **You must include either this or a `PhoneNumber` parameter to have your POST succeed.** (US and Canada only)
      * 
      * @param string $areaCode The desired area code for the new number
      * @return $this Fluent Builder
@@ -573,7 +576,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * Calls to this phone number will start a new TwiML session with this API version.
+     * The Twilio REST API version to use for incoming calls made to this number. If omitted, uses `2010-04-01`.
      * 
      * @param string $apiVersion The Twilio Rest API version to use
      * @return $this Fluent Builder
@@ -595,7 +598,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The 34 character sid of the application Twilio should use to handle SMSs sent to this number. If a `SmsApplicationSid` is present, Twilio will ignore all of the SMS urls above and use those set on the application.
+     * The 34 character sid of the application Twilio should use to handle SMSs sent to the new number. If a `SmsApplicationSid` is present, Twilio will ignore all of the SMS urls above and use those set on the application.
      * 
      * @param string $smsApplicationSid Unique string that identifies the
      *                                  application
@@ -607,7 +610,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use when requesting the above URL. Either `GET` or `POST`.
+     * The HTTP method that should be used to request the `SmsFallbackUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
      * @param string $smsFallbackMethod HTTP method used with sms fallback url
      * @return $this Fluent Builder
@@ -618,7 +621,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The URL that Twilio will request if an error occurs retrieving or executing the TwiML from `SmsUrl`.
+     * A URL that Twilio will request if an error occurs requesting or executing the TwiML defined by `SmsUrl`.
      * 
      * @param string $smsFallbackUrl URL Twilio will request if an error occurs in
      *                               executing TwiML
@@ -630,7 +633,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use when making requests to the `SmsUrl`. Either `GET` or `POST`.
+     * The HTTP method that should be used to request the `SmsUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
      * @param string $smsMethod HTTP method to use with sms url
      * @return $this Fluent Builder
@@ -663,7 +666,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use to make requests to the `StatusCallback` URL. Either `GET` or `POST`.
+     * The HTTP method Twilio will use to make requests to the `StatusCallback` URL. Either `GET` or `POST`. Defaults to `POST`.
      * 
      * @param string $statusCallbackMethod HTTP method twilio will use with status
      *                                     callback
@@ -675,7 +678,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The 34 character sid of the application Twilio should use to handle phone calls to this number. If a `VoiceApplicationSid` is present, Twilio will ignore all of the voice urls above and use those set on the application. Setting a `VoiceApplicationSid` will automatically delete your `TrunkSid` and vice versa.
+     * The 34 character sid of the application Twilio should use to handle phone calls to the new number. If a `VoiceApplicationSid` is present, Twilio will ignore all of the voice urls above and use those set on the application. Setting a `VoiceApplicationSid` will automatically delete your `TrunkSid` and vice versa.
      * 
      * @param string $voiceApplicationSid The unique sid of the application to
      *                                    handle this number
@@ -687,7 +690,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * Look up the caller's caller-ID name from the CNAM database ($0.01 per look up). Either `true` or `false`.
+     * Do a lookup of a caller's name from the CNAM database and post it to your app. Either `true` or `false`. Defaults to `false`.
      * 
      * @param boolean $voiceCallerIdLookup Look up the caller's caller-ID
      * @return $this Fluent Builder
@@ -698,7 +701,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use when requesting the `VoiceFallbackUrl`. Either `GET` or `POST`.
+     * The HTTP method that should be used to request the `VoiceFallbackUrl`. Either `GET` or `POST`. Defaults to `POST`.
      * 
      * @param string $voiceFallbackMethod HTTP method used with fallback_url
      * @return $this Fluent Builder
@@ -721,7 +724,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The HTTP method Twilio will use when requesting the above `Url`. Either `GET` or `POST`.
+     * The HTTP method that should be used to request the `VoiceUrl`. Must be either `GET` or `POST`. Defaults to `POST`.
      * 
      * @param string $voiceMethod HTTP method used with the voice url
      * @return $this Fluent Builder
@@ -732,7 +735,7 @@ class CreateIncomingPhoneNumberOptions extends Options {
     }
 
     /**
-     * The URL Twilio will request when this phone number receives a call. The VoiceURL will  no longer be used if a `VoiceApplicationSid` or a `TrunkSid` is set.
+     * The URL that Twilio should request when somebody dials the new phone number. The VoiceURL will  no longer be used if a `VoiceApplicationSid` or a `TrunkSid` is set.
      * 
      * @param string $voiceUrl URL Twilio will request when receiving a call
      * @return $this Fluent Builder

plugins/Twilio/Rest/Api/V2010/Account/IncomingPhoneNumberPage.php

@@ -36,6 +36,7 @@ class KeyContext extends InstanceContext {
      * Fetch a KeyInstance
      * 
      * @return KeyInstance Fetched KeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -59,6 +60,7 @@ class KeyContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return KeyInstance Updated KeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);
@@ -84,6 +86,7 @@ class KeyContext extends InstanceContext {
      * Deletes the KeyInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/KeyInstance.php

@@ -70,6 +70,7 @@ class KeyInstance extends InstanceResource {
      * Fetch a KeyInstance
      * 
      * @return KeyInstance Fetched KeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -80,6 +81,7 @@ class KeyInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return KeyInstance Updated KeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);
@@ -89,6 +91,7 @@ class KeyInstance extends InstanceResource {
      * Deletes the KeyInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/KeyList.php

@@ -14,7 +14,8 @@ use Twilio\Values;
 
 abstract class KeyOptions {
     /**
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A descriptive string for this resource, chosen
+     *                             by your application, up to 64 characters long.
      * @return UpdateKeyOptions Options builder
      */
     public static function update($friendlyName = Values::NONE) {
@@ -24,16 +25,18 @@ abstract class KeyOptions {
 
 class UpdateKeyOptions extends Options {
     /**
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A descriptive string for this resource, chosen
+     *                             by your application, up to 64 characters long.
      */
     public function __construct($friendlyName = Values::NONE) {
         $this->options['friendlyName'] = $friendlyName;
     }
 
     /**
-     * The friendly_name
+     * A descriptive string for this resource, chosen by your application, up to 64 characters long.
      * 
-     * @param string $friendlyName The friendly_name
+     * @param string $friendlyName A descriptive string for this resource, chosen
+     *                             by your application, up to 64 characters long.
      * @return $this Fluent Builder
      */
     public function setFriendlyName($friendlyName) {

plugins/Twilio/Rest/Api/V2010/Account/KeyPage.php

@@ -37,6 +37,7 @@ class FeedbackList extends ListResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return FeedbackInstance Newly created FeedbackInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/Message/FeedbackOptions.php

@@ -36,6 +36,7 @@ class MediaContext extends InstanceContext {
      * Deletes the MediaInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);
@@ -45,6 +46,7 @@ class MediaContext extends InstanceContext {
      * Fetch a MediaInstance
      * 
      * @return MediaInstance Fetched MediaInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());

plugins/Twilio/Rest/Api/V2010/Account/Message/MediaInstance.php

@@ -80,6 +80,7 @@ class MediaInstance extends InstanceResource {
      * Deletes the MediaInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();
@@ -89,6 +90,7 @@ class MediaInstance extends InstanceResource {
      * Fetch a MediaInstance
      * 
      * @return MediaInstance Fetched MediaInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();

plugins/Twilio/Rest/Api/V2010/Account/Message/MediaList.php

@@ -37,7 +37,7 @@ class ReadMediaOptions extends Options {
     }
 
     /**
-     * Only show media created on the given date, or before/after using date inequalities.
+     * Only show media created on the given date. Should be formatted as `YYYY-MM-DD`. You can also specify inequality, such as `DateCreated<=YYYY-MM-DD` for media generated at or before midnight on a date, and `DateCreated>=YYYY-MM-DD` for media generated at or after midnight on a date.
      * 
      * @param string $dateCreatedBefore Filter by date created
      * @return $this Fluent Builder
@@ -48,7 +48,7 @@ class ReadMediaOptions extends Options {
     }
 
     /**
-     * Only show media created on the given date, or before/after using date inequalities.
+     * Only show media created on the given date. Should be formatted as `YYYY-MM-DD`. You can also specify inequality, such as `DateCreated<=YYYY-MM-DD` for media generated at or before midnight on a date, and `DateCreated>=YYYY-MM-DD` for media generated at or after midnight on a date.
      * 
      * @param string $dateCreated Filter by date created
      * @return $this Fluent Builder
@@ -59,7 +59,7 @@ class ReadMediaOptions extends Options {
     }
 
     /**
-     * Only show media created on the given date, or before/after using date inequalities.
+     * Only show media created on the given date. Should be formatted as `YYYY-MM-DD`. You can also specify inequality, such as `DateCreated<=YYYY-MM-DD` for media generated at or before midnight on a date, and `DateCreated>=YYYY-MM-DD` for media generated at or after midnight on a date.
      * 
      * @param string $dateCreatedAfter Filter by date created
      * @return $this Fluent Builder

plugins/Twilio/Rest/Api/V2010/Account/Message/MediaPage.php

@@ -46,6 +46,7 @@ class MessageContext extends InstanceContext {
      * Deletes the MessageInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);
@@ -55,6 +56,7 @@ class MessageContext extends InstanceContext {
      * Fetch a MessageInstance
      * 
      * @return MessageInstance Fetched MessageInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -76,8 +78,10 @@ class MessageContext extends InstanceContext {
     /**
      * Update the MessageInstance
      * 
-     * @param string $body The body
+     * @param string $body The text of the message you want to send, limited to
+     *                     1600 characters.
      * @return MessageInstance Updated MessageInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($body) {
         $data = Values::of(array('Body' => $body, ));

plugins/Twilio/Rest/Api/V2010/Account/MessageInstance.php

@@ -103,6 +103,7 @@ class MessageInstance extends InstanceResource {
      * Deletes the MessageInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();
@@ -112,6 +113,7 @@ class MessageInstance extends InstanceResource {
      * Fetch a MessageInstance
      * 
      * @return MessageInstance Fetched MessageInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -120,8 +122,10 @@ class MessageInstance extends InstanceResource {
     /**
      * Update the MessageInstance
      * 
-     * @param string $body The body
+     * @param string $body The text of the message you want to send, limited to
+     *                     1600 characters.
      * @return MessageInstance Updated MessageInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($body) {
         return $this->proxy()->update($body);

plugins/Twilio/Rest/Api/V2010/Account/MessageList.php

@@ -38,6 +38,7 @@ class MessageList extends ListResource {
      * @param string $to The phone number to receive the message
      * @param array|Options $options Optional Arguments
      * @return MessageInstance Newly created MessageInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($to, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/MessageOptions.php

@@ -15,14 +15,24 @@ use Twilio\Values;
 abstract class MessageOptions {
     /**
      * @param string $from The phone number that initiated the message
-     * @param string $messagingServiceSid The messaging_service_sid
-     * @param string $body The body
-     * @param string $mediaUrl The media_url
+     * @param string $messagingServiceSid The 34 character unique id of the
+     *                                    Messaging Service you want to associate
+     *                                    with this Message.
+     * @param string $body The text of the message you want to send, limited to
+     *                     1600 characters.
+     * @param string $mediaUrl The URL of the media you wish to send out with the
+     *                         message.
      * @param string $statusCallback URL Twilio will request when the status changes
      * @param string $applicationSid The application to use for callbacks
-     * @param string $maxPrice The max_price
-     * @param boolean $provideFeedback The provide_feedback
-     * @param integer $validityPeriod The validity_period
+     * @param string $maxPrice The total maximum price up to the fourth decimal in
+     *                         US dollars acceptable for the message to be
+     *                         delivered.
+     * @param boolean $provideFeedback Set this value to true if you are sending
+     *                                 messages that have a trackable user action
+     *                                 and you intend to confirm delivery of the
+     *                                 message using the Message Feedback API.
+     * @param integer $validityPeriod The number of seconds that the message can
+     *                                remain in a Twilio queue.
      * @param string $maxRate The max_rate
      * @param boolean $forceDelivery The force_delivery
      * @param string $providerSid The provider_sid
@@ -51,14 +61,24 @@ abstract class MessageOptions {
 class CreateMessageOptions extends Options {
     /**
      * @param string $from The phone number that initiated the message
-     * @param string $messagingServiceSid The messaging_service_sid
-     * @param string $body The body
-     * @param string $mediaUrl The media_url
+     * @param string $messagingServiceSid The 34 character unique id of the
+     *                                    Messaging Service you want to associate
+     *                                    with this Message.
+     * @param string $body The text of the message you want to send, limited to
+     *                     1600 characters.
+     * @param string $mediaUrl The URL of the media you wish to send out with the
+     *                         message.
      * @param string $statusCallback URL Twilio will request when the status changes
      * @param string $applicationSid The application to use for callbacks
-     * @param string $maxPrice The max_price
-     * @param boolean $provideFeedback The provide_feedback
-     * @param integer $validityPeriod The validity_period
+     * @param string $maxPrice The total maximum price up to the fourth decimal in
+     *                         US dollars acceptable for the message to be
+     *                         delivered.
+     * @param boolean $provideFeedback Set this value to true if you are sending
+     *                                 messages that have a trackable user action
+     *                                 and you intend to confirm delivery of the
+     *                                 message using the Message Feedback API.
+     * @param integer $validityPeriod The number of seconds that the message can
+     *                                remain in a Twilio queue.
      * @param string $maxRate The max_rate
      * @param boolean $forceDelivery The force_delivery
      * @param string $providerSid The provider_sid
@@ -85,7 +105,7 @@ class CreateMessageOptions extends Options {
     }
 
     /**
-     * A Twilio phone number or alphanumeric sender ID enabled for the type of message you wish to send.
+     * A Twilio phone number (in [E.164](https://www.twilio.com/docs/glossary/what-e164) format),  [alphanumeric sender ID](https://www.twilio.com/docs/api/messaging/send-messages#alpha-sender-id) or a [Channel Endpoint address](https://www.twilio.com/docs/api/channels#channel-addresses) enabled for the type of message you wish to send. Phone numbers or [short codes](https://www.twilio.com/docs/sms/api/short-codes) purchased from Twilio work here. You cannot (for example) spoof messages from your own cell phone number. *Should not be passed if you are using MessagingServiceSid.*
      * 
      * @param string $from The phone number that initiated the message
      * @return $this Fluent Builder
@@ -96,9 +116,11 @@ class CreateMessageOptions extends Options {
     }
 
     /**
-     * The messaging_service_sid
+     * The 34 character unique id of the [Messaging Service](https://www.twilio.com/docs/api/messaging/send-messages#messaging-services) you want to associate with this Message. Set this parameter to use the Messaging Service Settings and [Copilot Features](https://www.twilio.com/docs/api/messaging/send-messages-copilot) you have configured. When only this parameter is set, Twilio will use your enabled Copilot Features to select the From phone number for delivery. *Should not be passed if you are using From.*
      * 
-     * @param string $messagingServiceSid The messaging_service_sid
+     * @param string $messagingServiceSid The 34 character unique id of the
+     *                                    Messaging Service you want to associate
+     *                                    with this Message.
      * @return $this Fluent Builder
      */
     public function setMessagingServiceSid($messagingServiceSid) {
@@ -107,9 +129,10 @@ class CreateMessageOptions extends Options {
     }
 
     /**
-     * The body
+     * The text of the message you want to send, limited to 1600 characters.
      * 
-     * @param string $body The body
+     * @param string $body The text of the message you want to send, limited to
+     *                     1600 characters.
      * @return $this Fluent Builder
      */
     public function setBody($body) {
@@ -118,9 +141,10 @@ class CreateMessageOptions extends Options {
     }
 
     /**
-     * The media_url
+     * The URL of the media you wish to send out with the message. `gif` , `png` and `jpeg` content is currently supported and will be formatted correctly on the recipient's device. [Other types](https://www.twilio.com/docs/api/messaging/accepted-mime-types) are also accepted by the API. The media size limit is 5MB. If you wish to send more than one image in the message body, please provide multiple MediaUrls values in the POST request. You may include up to 10 MediaUrls per message.
      * 
-     * @param string $mediaUrl The media_url
+     * @param string $mediaUrl The URL of the media you wish to send out with the
+     *                         message.
      * @return $this Fluent Builder
      */
     public function setMediaUrl($mediaUrl) {
@@ -129,7 +153,7 @@ class CreateMessageOptions extends Options {
     }
 
     /**
-     * The URL that Twilio will POST to each time your message status changes
+     * A URL where Twilio will POST each time your message status changes to one of the following: `queued`, `failed`, `sent`, `delivered`, or `undelivered`. Twilio will POST the `MessageSid` along with the other [standard request parameters](https://www.twilio.com/docs/api/twiml/sms/twilio_request#request-parameters) as well as `MessageStatus` and `ErrorCode`. If this parameter passed in addition to a `MessagingServiceSid`, Twilio will override the Status Callback URL of the [Messaging Service](https://www.twilio.com/docs/api/messaging/send-messages#messaging-services). URLs must contain a valid hostname (underscores are not allowed).
      * 
      * @param string $statusCallback URL Twilio will request when the status changes
      * @return $this Fluent Builder
@@ -140,7 +164,7 @@ class CreateMessageOptions extends Options {
     }
 
     /**
-     * Twilio the POST MessageSid as well as MessageStatus to the URL in the MessageStatusCallback property of this Application
+     * Twilio will POST `MessageSid` as well as `MessageStatus=sent` or `MessageStatus=failed` to the URL in the `MessageStatusCallback` property of this [Application](https://www.twilio.com/docs/api/rest/applications). If the `StatusCallback` parameter above is also passed, the Application's `MessageStatusCallback` parameter will take precedence.
      * 
      * @param string $applicationSid The application to use for callbacks
      * @return $this Fluent Builder
@@ -151,9 +175,11 @@ class CreateMessageOptions extends Options {
     }
 
     /**
-     * The max_price
+     * The total maximum price up to the fourth decimal (0.0001) in US dollars acceptable for the message to be delivered. All messages regardless of the price point will be queued for delivery. A POST request will later be made to your Status Callback URL with a status change of 'Sent' or 'Failed'. When the price of the message is above this value the message will fail and not be sent. When MaxPrice is not set, all prices for the message is accepted.
      * 
-     * @param string $maxPrice The max_price
+     * @param string $maxPrice The total maximum price up to the fourth decimal in
+     *                         US dollars acceptable for the message to be
+     *                         delivered.
      * @return $this Fluent Builder
      */
     public function setMaxPrice($maxPrice) {
@@ -162,9 +188,12 @@ class CreateMessageOptions extends Options {
     }
 
     /**
-     * The provide_feedback
+     * Set this value to `true` if you are sending messages that have a trackable user action and you intend to confirm delivery of the message using the [Message Feedback API](https://www.twilio.com/docs/api/messaging/message-feedback). This parameter is set to `false` by default.
      * 
-     * @param boolean $provideFeedback The provide_feedback
+     * @param boolean $provideFeedback Set this value to true if you are sending
+     *                                 messages that have a trackable user action
+     *                                 and you intend to confirm delivery of the
+     *                                 message using the Message Feedback API.
      * @return $this Fluent Builder
      */
     public function setProvideFeedback($provideFeedback) {
@@ -173,9 +202,10 @@ class CreateMessageOptions extends Options {
     }
 
     /**
-     * The validity_period
+     * The number of seconds that the message can remain in a Twilio queue. After exceeding this time limit, the message will fail and a POST request will later be made to your Status Callback URL. Valid values are between 1 and 14400 seconds (the default). Please note that Twilio cannot guarantee that a message will not be queued by the carrier after they accept the message. We do not recommend setting validity periods of less than 5 seconds.
      * 
-     * @param integer $validityPeriod The validity_period
+     * @param integer $validityPeriod The number of seconds that the message can
+     *                                remain in a Twilio queue.
      * @return $this Fluent Builder
      */
     public function setValidityPeriod($validityPeriod) {
@@ -282,7 +312,7 @@ class ReadMessageOptions extends Options {
     }
 
     /**
-     * Filter by messages to this number
+     * Only show messages to this phone number.
      * 
      * @param string $to Filter by messages to this number
      * @return $this Fluent Builder
@@ -293,7 +323,7 @@ class ReadMessageOptions extends Options {
     }
 
     /**
-     * Only show messages from this phone number
+     * Only show messages from this phone number or alphanumeric sender ID.
      * 
      * @param string $from Filter by from number
      * @return $this Fluent Builder
@@ -304,7 +334,7 @@ class ReadMessageOptions extends Options {
     }
 
     /**
-     * Filter messages sent by this date
+     * Only show messages sent on this date (in [GMT](https://en.wikipedia.org/wiki/Greenwich_Mean_Time) format), given as `YYYY-MM-DD`. Example: `DateSent=2009-07-06`. You can also specify inequality, such as `DateSent<=YYYY-MM-DD` for messages that were sent on or before midnight on a date, and `DateSent>=YYYY-MM-DD` for messages sent on or after midnight on a date.
      * 
      * @param string $dateSentBefore Filter by date sent
      * @return $this Fluent Builder
@@ -315,7 +345,7 @@ class ReadMessageOptions extends Options {
     }
 
     /**
-     * Filter messages sent by this date
+     * Only show messages sent on this date (in [GMT](https://en.wikipedia.org/wiki/Greenwich_Mean_Time) format), given as `YYYY-MM-DD`. Example: `DateSent=2009-07-06`. You can also specify inequality, such as `DateSent<=YYYY-MM-DD` for messages that were sent on or before midnight on a date, and `DateSent>=YYYY-MM-DD` for messages sent on or after midnight on a date.
      * 
      * @param string $dateSent Filter by date sent
      * @return $this Fluent Builder
@@ -326,7 +356,7 @@ class ReadMessageOptions extends Options {
     }
 
     /**
-     * Filter messages sent by this date
+     * Only show messages sent on this date (in [GMT](https://en.wikipedia.org/wiki/Greenwich_Mean_Time) format), given as `YYYY-MM-DD`. Example: `DateSent=2009-07-06`. You can also specify inequality, such as `DateSent<=YYYY-MM-DD` for messages that were sent on or before midnight on a date, and `DateSent>=YYYY-MM-DD` for messages sent on or after midnight on a date.
      * 
      * @param string $dateSentAfter Filter by date sent
      * @return $this Fluent Builder

plugins/Twilio/Rest/Api/V2010/Account/MessagePage.php

@@ -37,6 +37,7 @@ class NewKeyList extends ListResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return NewKeyInstance Newly created NewKeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/NewKeyOptions.php

@@ -37,6 +37,7 @@ class NewSigningKeyList extends ListResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return NewSigningKeyInstance Newly created NewSigningKeyInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/NewSigningKeyOptions.php

@@ -35,6 +35,7 @@ class NotificationContext extends InstanceContext {
      * Fetch a NotificationInstance
      * 
      * @return NotificationInstance Fetched NotificationInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -57,6 +58,7 @@ class NotificationContext extends InstanceContext {
      * Deletes the NotificationInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/NotificationInstance.php

@@ -94,6 +94,7 @@ class NotificationInstance extends InstanceResource {
      * Fetch a NotificationInstance
      * 
      * @return NotificationInstance Fetched NotificationInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -103,6 +104,7 @@ class NotificationInstance extends InstanceResource {
      * Deletes the NotificationInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/NotificationList.php

@@ -40,7 +40,7 @@ class ReadNotificationOptions extends Options {
     }
 
     /**
-     * Only show notifications for this log level
+     * Only show notifications for this log, using the integer log values shown above.
      * 
      * @param integer $log Filter by log level
      * @return $this Fluent Builder
@@ -51,7 +51,7 @@ class ReadNotificationOptions extends Options {
     }
 
     /**
-     * Only show notifications for this date. Should be formatted as YYYY-MM-DD. You can also specify inequalities.
+     * Only show notifications for this date. Should be formatted as `YYYY-MM-DD`. You can also specify inequality, such as `MessageDate<=YYYY-MM-DD` for messages logged at or before midnight on a date, and `MessageDate>=YYYY-MM-DD` for messages logged at or after midnight on a date.
      * 
      * @param string $messageDateBefore Filter by date
      * @return $this Fluent Builder
@@ -62,7 +62,7 @@ class ReadNotificationOptions extends Options {
     }
 
     /**
-     * Only show notifications for this date. Should be formatted as YYYY-MM-DD. You can also specify inequalities.
+     * Only show notifications for this date. Should be formatted as `YYYY-MM-DD`. You can also specify inequality, such as `MessageDate<=YYYY-MM-DD` for messages logged at or before midnight on a date, and `MessageDate>=YYYY-MM-DD` for messages logged at or after midnight on a date.
      * 
      * @param string $messageDate Filter by date
      * @return $this Fluent Builder
@@ -73,7 +73,7 @@ class ReadNotificationOptions extends Options {
     }
 
     /**
-     * Only show notifications for this date. Should be formatted as YYYY-MM-DD. You can also specify inequalities.
+     * Only show notifications for this date. Should be formatted as `YYYY-MM-DD`. You can also specify inequality, such as `MessageDate<=YYYY-MM-DD` for messages logged at or before midnight on a date, and `MessageDate>=YYYY-MM-DD` for messages logged at or after midnight on a date.
      * 
      * @param string $messageDateAfter Filter by date
      * @return $this Fluent Builder

plugins/Twilio/Rest/Api/V2010/Account/NotificationPage.php

@@ -36,6 +36,7 @@ class OutgoingCallerIdContext extends InstanceContext {
      * Fetch a OutgoingCallerIdInstance
      * 
      * @return OutgoingCallerIdInstance Fetched OutgoingCallerIdInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -59,6 +60,7 @@ class OutgoingCallerIdContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return OutgoingCallerIdInstance Updated OutgoingCallerIdInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);
@@ -84,6 +86,7 @@ class OutgoingCallerIdContext extends InstanceContext {
      * Deletes the OutgoingCallerIdInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/OutgoingCallerIdInstance.php

@@ -76,6 +76,7 @@ class OutgoingCallerIdInstance extends InstanceResource {
      * Fetch a OutgoingCallerIdInstance
      * 
      * @return OutgoingCallerIdInstance Fetched OutgoingCallerIdInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -86,6 +87,7 @@ class OutgoingCallerIdInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return OutgoingCallerIdInstance Updated OutgoingCallerIdInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);
@@ -95,6 +97,7 @@ class OutgoingCallerIdInstance extends InstanceResource {
      * Deletes the OutgoingCallerIdInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/OutgoingCallerIdList.php

@@ -40,7 +40,7 @@ class UpdateOutgoingCallerIdOptions extends Options {
     }
 
     /**
-     * A human readable description of the caller ID
+     * A human readable description of a Caller ID, with maximum length of 64 characters. Defaults to a nicely formatted version of the phone number.
      * 
      * @param string $friendlyName A human readable description of the caller ID
      * @return $this Fluent Builder
@@ -77,7 +77,7 @@ class ReadOutgoingCallerIdOptions extends Options {
     }
 
     /**
-     * Only show the caller id resource that exactly matches this phone number
+     * Only show the caller id resource that exactly matches this phone number.
      * 
      * @param string $phoneNumber Filter by phone number
      * @return $this Fluent Builder
@@ -88,7 +88,7 @@ class ReadOutgoingCallerIdOptions extends Options {
     }
 
     /**
-     * Only show the caller id resource that exactly matches this name
+     * Only show the caller id resource that exactly matches this name.
      * 
      * @param string $friendlyName Filter by friendly name
      * @return $this Fluent Builder

plugins/Twilio/Rest/Api/V2010/Account/OutgoingCallerIdPage.php

@@ -40,6 +40,7 @@ class MemberContext extends InstanceContext {
      * Fetch a MemberInstance
      * 
      * @return MemberInstance Fetched MemberInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -65,6 +66,7 @@ class MemberContext extends InstanceContext {
      * @param string $url The url
      * @param string $method The method
      * @return MemberInstance Updated MemberInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($url, $method) {
         $data = Values::of(array('Url' => $url, 'Method' => $method, ));

plugins/Twilio/Rest/Api/V2010/Account/Queue/MemberInstance.php

@@ -76,6 +76,7 @@ class MemberInstance extends InstanceResource {
      * Fetch a MemberInstance
      * 
      * @return MemberInstance Fetched MemberInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -87,6 +88,7 @@ class MemberInstance extends InstanceResource {
      * @param string $url The url
      * @param string $method The method
      * @return MemberInstance Updated MemberInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($url, $method) {
         return $this->proxy()->update($url, $method);

plugins/Twilio/Rest/Api/V2010/Account/Queue/MemberList.php

@@ -44,6 +44,7 @@ class QueueContext extends InstanceContext {
      * Fetch a QueueInstance
      * 
      * @return QueueInstance Fetched QueueInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -67,6 +68,7 @@ class QueueContext extends InstanceContext {
      * 
      * @param array|Options $options Optional Arguments
      * @return QueueInstance Updated QueueInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         $options = new Values($options);
@@ -95,6 +97,7 @@ class QueueContext extends InstanceContext {
      * Deletes the QueueInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/QueueInstance.php

@@ -81,6 +81,7 @@ class QueueInstance extends InstanceResource {
      * Fetch a QueueInstance
      * 
      * @return QueueInstance Fetched QueueInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -91,6 +92,7 @@ class QueueInstance extends InstanceResource {
      * 
      * @param array|Options $options Optional Arguments
      * @return QueueInstance Updated QueueInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function update($options = array()) {
         return $this->proxy()->update($options);
@@ -100,6 +102,7 @@ class QueueInstance extends InstanceResource {
      * Deletes the QueueInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/QueueList.php

@@ -124,6 +124,7 @@ class QueueList extends ListResource {
      *                             queue.
      * @param array|Options $options Optional Arguments
      * @return QueueInstance Newly created QueueInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function create($friendlyName, $options = array()) {
         $options = new Values($options);

plugins/Twilio/Rest/Api/V2010/Account/QueueOptions.php

@@ -42,6 +42,7 @@ class PayloadContext extends InstanceContext {
      * Fetch a PayloadInstance
      * 
      * @return PayloadInstance Fetched PayloadInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -66,6 +67,7 @@ class PayloadContext extends InstanceContext {
      * Deletes the PayloadInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);

plugins/Twilio/Rest/Api/V2010/Account/Recording/AddOnResult/PayloadInstance.php

@@ -90,6 +90,7 @@ class PayloadInstance extends InstanceResource {
      * Fetch a PayloadInstance
      * 
      * @return PayloadInstance Fetched PayloadInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         return $this->proxy()->fetch();
@@ -99,6 +100,7 @@ class PayloadInstance extends InstanceResource {
      * Deletes the PayloadInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->proxy()->delete();

plugins/Twilio/Rest/Api/V2010/Account/Recording/AddOnResult/PayloadList.php

@@ -48,6 +48,7 @@ class AddOnResultContext extends InstanceContext {
      * Fetch a AddOnResultInstance
      * 
      * @return AddOnResultInstance Fetched AddOnResultInstance
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function fetch() {
         $params = Values::of(array());
@@ -71,6 +72,7 @@ class AddOnResultContext extends InstanceContext {
      * Deletes the AddOnResultInstance
      * 
      * @return boolean True if delete succeeds, false otherwise
+     * @throws TwilioException When an HTTP error occurs.
      */
     public function delete() {
         return $this->version->delete('delete', $this->uri);