UAPI Email::set_always_accept documentation

swbrains

• June 04, 2021 10:47

With regard to the UAPI function Email::set_always_accept documented here: This parameter is redundant with the alwaysaccept parameter. Do not enter the mxcheck and alwaysaccept parameter at the same time. Undefined behavior may occur if this happens. The "alwaysaccept" parameter has the following note: This parameter is redundant with the mxcheck parameter. Do not enter the mxcheck and alwaysaccept parameter at the same time. Undefined behavior may occur if this happens. In the examples section, two of the examples provided (command line and cPanel/webmail session) show both parameters in use at the same time: uapi --user=username Email set_always_accept domain=example.com mxcheck=auto alwaysaccept=1 https://hostname.example.com:2083/cpsess##########/execute/Email/set_always_accept?domain=example.com&mxcheck=auto&alwaysaccept=1
Also, in these examples, alwaysaccept is set to "1" whereas the documentation indicates that alwaysaccept's valid values are the same as mxcheck (strings): auto, local, secondary, or remote. Am I not understanding this correctly or should only one of these two params be used at a time? Also what are the acceptable values for the alwaysaccept parameter? Thanks for any clarification you can provide.

• 

  cPRex Jurassic Moderator

  • June 04, 2021 20:41

  Hey there! You're completely right, and we have this resolved in our latest documentation. The "documentation" site is actually two versions old in relation to the API, and the new stuff is here:

  0
• 

  swbrains

  • June 04, 2021 21:28

  Thanks! I always end up Google-ing "API cpanel __________" when I need to look up a function for a particular purpose, and it seems I've usually landed on the old API site It might be helpful if it could redirect to the new one as I don't visit it frequently enough to remember there's a newer version. One thing I noticed on the new page is the CLI and URL examples don't specify any parameters other than . With a function called set_always_accept, I would have expected it to require a setting/value to be set -- either or , but didn't see them being set in the example. I see that other information is returned by the function, but it's unclear if the example is being used to simply query the MX information for the domain, or what the purpose of the function is when only the parameter is specified with no "action." Thanks for any additional clarification you can provide. :)

  0
• 

  cPRex Jurassic Moderator

  • June 15, 2021 16:58

  While we don't have a redirect in place, there is a "Check out our new API site!" message at the top of all the pages in the Developer Documentation Home - Developer Documentation - cPanel Documentation area. I reached out to our developers about the requirements for that API call as I wasn't able to find any official details in my research. I'll be sure to post as soon as I hear back with more information.

  0
• 

  swbrains

  • June 15, 2021 17:06

  Thanks!

  0
• 

  cPRex Jurassic Moderator

  • June 15, 2021 17:42

  If the command is run with no value applied, such as this example: uapi --user=main Email set_always_accept domain=domain.com
  the value is set to "auto" for the mxcheck value. In general, it is expected to provide one of the values, and I have one of our API guys making some edits to that page to make this more clear in the future.

  0

Please sign in to leave a comment.