Documentation link

https://pan.dev/scm/api/config/ngfw/security/create-security-rules/
and all other documentation pages relating to creation and updating of various rule types, both for NGFW and SASE.

Describe the problem

The documentation for how to create rules in all of the various rule bases via the SCM API is woefully inadequate. Absolutely no details are provided on the acceptable structure of the rule parameters themselves. Additionally, some but not all of the create rule documents list a "position" parameter, with no explanation of how this parameter works or what values it accepts. There also is no documentation of what the response should include for rule creation API calls. It just says "Created".

Suggested fix

SCM API documentation needs to be dramatically expanded on.