diff --git a/api-ref/source/v3/index.rst b/api-ref/source/v3/index.rst
index 7ade2a0f78..5caa38dcc2 100644
--- a/api-ref/source/v3/index.rst
+++ b/api-ref/source/v3/index.rst
@@ -199,7 +199,7 @@ This page lists the Identity API operations in the following order:
 * `Unified Limits`_
 * `Users`_
 * `OS-INHERIT`_
-* `OS-PKI API`_
+* `OS-PKI`_
 
 .. rest_expand_all::
 
diff --git a/api-ref/source/v3/os-pki.inc b/api-ref/source/v3/os-pki.inc
index d45c79543c..934c283b61 100644
--- a/api-ref/source/v3/os-pki.inc
+++ b/api-ref/source/v3/os-pki.inc
@@ -1,7 +1,7 @@
 .. -*- rst -*-
 
 ==========
-OS-PKI API
+OS-PKI
 ==========
 
 List revoked tokens
@@ -9,24 +9,42 @@ List revoked tokens
 
 .. rest_method:: GET /v3/auth/tokens/OS-PKI/revoked
 
+Lists revoked PKI tokens.
+
 Relationship:
 ``https://docs.openstack.org/api/openstack-identity/3/rel/tokens/OS-PKI/revoked``
 
-Lists revoked PKI tokens.
-
-Normal response codes: 200
-
-Error response codes: 413,415,405,404,403,401,400,503,409
-
 Response
 --------
 
+Parameters
+~~~~~~~~~~
+
 .. rest_parameters:: parameters.yaml
 
    - signed: signed
 
-Response Example
-----------------
+Status Codes
+~~~~~~~~~~~~
+
+.. rest_status_code:: success status.yaml
+
+   - 200
+
+.. rest_status_code:: error status.yaml
+
+   - 413
+   - 415
+   - 405
+   - 404
+   - 403
+   - 401
+   - 400
+   - 503
+   - 409
+
+Example
+~~~~~~~
 
 .. literalinclude:: samples/admin/get-pki-revoked-response.json
-   :language: javascript
+   :language: javascript
\ No newline at end of file