docs: def update(name,
             endpoint='incidents',
             id=None,
             api_url=None,
             page_id=None,
             api_key=None,
             api_version=None,
             **kwargs):
      '''
      Update attribute(s) of a specific endpoint.
  
      id
          The unique ID of the enpoint entry.
  
      endpoint: incidents
          Endpoint name.
  
      page_id
          Page ID. Can also be specified in the config file.
  
      api_key
          API key. Can also be specified in the config file.
  
      api_version: 1
          API version. Can also be specified in the config file.
  
      api_url
          Custom API URL in case the user has a StatusPage service running in a custom environment.
  
      SLS Example:
  
      .. code-block:: yaml
  
          update-my-incident:
              statuspage.update:
                  - id: dz959yz2nd4l
                  - status: resolved
      '''
      ret = _default_ret(name)
      endpoint_sg = endpoint[:-1]  # singular
      if not id:
          log.error('Invalid %s ID', endpoint_sg)
          ret['comment'] = 'Please specify a valid {endpoint} ID'.format(endpoint=endpoint_sg)
          return ret
      if __opts__['test']:
          ret['comment'] = '{endpoint} #{id} would be updated:'.format(endpoint=endpoint_sg, id=id)
          ret['result'] = None
          ret['changes'][endpoint] = {}
          for karg, warg in six.iteritems(kwargs):
              if warg is None or karg.startswith('__'):
                  continue
              ret['changes'][endpoint][karg] = warg
          return ret
      sp_update = __salt__['statuspage.update'](endpoint=endpoint,
                                                id=id,
                                                api_url=api_url,
                                                page_id=page_id,
                                                api_key=api_key,
                                                api_version=api_version,
                                                **kwargs)
      if not sp_update.get('result'):
          ret['comment'] = 'Unable to update {endpoint} #{id}: {msg}'.format(endpoint=endpoint_sg,
                                                                             id=id,
                                                                             msg=sp_update.get('comment'))
      else:
          ret['comment'] = '{endpoint} #{id} updated!'.format(endpoint=endpoint_sg, id=id)
          ret['result'] = True
          ret['changes'] = sp_update.get('out')