docs: def create_example(self,
                         workspace_id,
                         intent,
                         text,
                         mentions=None,
                         **kwargs):
          """
          Create user input example.
  
          Add a new user input example to an intent.
          This operation is limited to 1000 requests per 30 minutes. For more information,
          see **Rate limiting**.
  
          :param str workspace_id: Unique identifier of the workspace.
          :param str intent: The intent name.
          :param str text: The text of a user input example. This string must conform to the
          following restrictions:
          - It cannot contain carriage return, newline, or tab characters.
          - It cannot consist of only whitespace characters.
          - It must be no longer than 1024 characters.
          :param list[Mention] mentions: An array of contextual entity mentions.
          :param dict headers: A `dict` containing the request headers
          :return: A `DetailedResponse` containing the result, headers and HTTP status code.
          :rtype: DetailedResponse
          """
  
          if workspace_id is None:
              raise ValueError('workspace_id must be provided')
          if intent is None:
              raise ValueError('intent must be provided')
          if text is None:
              raise ValueError('text must be provided')
          if mentions is not None:
              mentions = [self._convert_model(x, Mention) for x in mentions]
  
          headers = {}
          if 'headers' in kwargs:
              headers.update(kwargs.get('headers'))
          sdk_headers = get_sdk_headers('conversation', 'V1', 'create_example')
          headers.update(sdk_headers)
  
          params = {'version': self.version}
  
          data = {'text': text, 'mentions': mentions}
  
          url = '/v1/workspaces/{0}/intents/{1}/examples'.format(
              *self._encode_path_vars(workspace_id, intent))
          response = self.request(
              method='POST',
              url=url,
              headers=headers,
              params=params,
              json=data,
              accept_json=True)
          return response