-Note: if the policy version is specified, then it
-may be an integer, or it may be a fully qualified version (e.g., "3.0.2").
-On the other hand, if left unspecified, then the latest deployed version
-will be undeployed.
+This operation allows policies to be undeployed from PDP groups.
+
+.. note::
+ If the policy version is specified, then it may be an integer, or it may be a fully qualified version (e.g., "3.0.2").
+ On the other hand, if left unspecified, then the latest deployed version will be undeployed.
+
+.. note::
+ Due to current limitations, a fully qualified policy version must always be specified.
+
+Here is a sample response:
+
+.. literalinclude:: response/deployment-pap-resp.json
+ :language: json
+
+:download:`Download Policy Status PAP API Swagger <swagger/policy-status-pap.json>`
+
+.. swaggerv2doc:: swagger/policy-status-pap.json
+
+This operation allows the status of all policies that are deployed or undeployed to be listed together.
+The result can be filtered based on pdp group name, policy name & version.
+
+.. note::
+ When a policy is successfully undeployed, it will no longer appear in the policy status response.
+
+Here is a sample response:
+
+.. literalinclude:: response/policy-status-pap-resp.json
+ :language: json
+
+:download:`Download Deployed Policy PAP API Swagger <swagger/deployed-policy-pap.json>`
+
+.. swaggerv2doc:: swagger/deployed-policy-pap.json
+
+This operation allows the deployed policies to be listed together with their respective deployment status.
+The result can be filtered based on policy name & version.
+
+Here is a sample response:
+
+.. literalinclude:: response/deployed-policy-pap-resp.json
+ :language: json
+
+:download:`Download PDP Statistics PAP API Swagger <swagger/pdp-statistics-pap.json>`
+
+.. swaggerv2doc:: swagger/pdp-statistics-pap.json
+
+This operation allows the PDP statistics to be retrieved for all registered PDPs.
+The result can be filtered based on PDP group, PDP subgroup & PDP instance.
+
+Here is a sample response:
+
+.. literalinclude:: response/pdp-statistics-pap-resp.json
+ :language: json
+
+
+3 Future Features
+=================
+
+3.1 Disable policies in PDP
+===========================