:doc:`Pinpoint <../../pinpoint>` / Client / update_voice_channel

********************
update_voice_channel
********************



.. py:method:: Pinpoint.Client.update_voice_channel(**kwargs)

  

  Enables the voice channel for an application or updates the status and settings of the voice channel for an application.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/pinpoint-2016-12-01/UpdateVoiceChannel>`_  


  **Request Syntax**
  ::

    response = client.update_voice_channel(
        ApplicationId='string',
        VoiceChannelRequest={
            'Enabled': True|False
        }
    )
    
  :type ApplicationId: string
  :param ApplicationId: **[REQUIRED]** 

    The unique identifier for the application. This identifier is displayed as the **Project ID** on the Amazon Pinpoint console.

    

  
  :type VoiceChannelRequest: dict
  :param VoiceChannelRequest: **[REQUIRED]** 

    Specifies the status and settings of the voice channel for an application.

    

  
    - **Enabled** *(boolean) --* 

      Specifies whether to enable the voice channel for the application.

      

    
  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'VoiceChannelResponse': {
              'ApplicationId': 'string',
              'CreationDate': 'string',
              'Enabled': True|False,
              'HasCredential': True|False,
              'Id': 'string',
              'IsArchived': True|False,
              'LastModifiedBy': 'string',
              'LastModifiedDate': 'string',
              'Platform': 'string',
              'Version': 123
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 

      The request succeeded.

      
      

      - **VoiceChannelResponse** *(dict) --* 

        Provides information about the status and settings of the voice channel for an application.

        
        

        - **ApplicationId** *(string) --* 

          The unique identifier for the application that the voice channel applies to.

          
        

        - **CreationDate** *(string) --* 

          The date and time, in ISO 8601 format, when the voice channel was enabled.

          
        

        - **Enabled** *(boolean) --* 

          Specifies whether the voice channel is enabled for the application.

          
        

        - **HasCredential** *(boolean) --* 

          (Not used) This property is retained only for backward compatibility.

          
        

        - **Id** *(string) --* 

          (Deprecated) An identifier for the voice channel. This property is retained only for backward compatibility.

          
        

        - **IsArchived** *(boolean) --* 

          Specifies whether the voice channel is archived.

          
        

        - **LastModifiedBy** *(string) --* 

          The user who last modified the voice channel.

          
        

        - **LastModifiedDate** *(string) --* 

          The date and time, in ISO 8601 format, when the voice channel was last modified.

          
        

        - **Platform** *(string) --* 

          The type of messaging or notification platform for the channel. For the voice channel, this value is VOICE.

          
        

        - **Version** *(integer) --* 

          The current version of the voice channel.

          
    
  
  **Exceptions**
  
  *   :py:class:`Pinpoint.Client.exceptions.BadRequestException`

  
  *   :py:class:`Pinpoint.Client.exceptions.InternalServerErrorException`

  
  *   :py:class:`Pinpoint.Client.exceptions.PayloadTooLargeException`

  
  *   :py:class:`Pinpoint.Client.exceptions.ForbiddenException`

  
  *   :py:class:`Pinpoint.Client.exceptions.NotFoundException`

  
  *   :py:class:`Pinpoint.Client.exceptions.MethodNotAllowedException`

  
  *   :py:class:`Pinpoint.Client.exceptions.TooManyRequestsException`

  