diff --git a/api-ref/source/v3-ext/federation.inc b/api-ref/source/v3-ext/federation.inc
index 02504aa191..7cb3fc028b 100644
--- a/api-ref/source/v3-ext/federation.inc
+++ b/api-ref/source/v3-ext/federation.inc
@@ -294,6 +294,8 @@ If a value is not specified by the client, the service will default this value
 to ``ss:mem:``.
 
 
+.. include:: federation/identity-provider/idp.inc
+
 .. TODO(samueldmq): This is the Mapping API, move it to its own file.
 
 Create a mapping
diff --git a/api-ref/source/v3-ext/federation/identity-provider/index.inc b/api-ref/source/v3-ext/federation/identity-provider/idp.inc
similarity index 94%
rename from api-ref/source/v3-ext/federation/identity-provider/index.inc
rename to api-ref/source/v3-ext/federation/identity-provider/idp.inc
index f4210d2e4e..b4f21fe2c6 100644
--- a/api-ref/source/v3-ext/federation/identity-provider/index.inc
+++ b/api-ref/source/v3-ext/federation/identity-provider/idp.inc
@@ -1,13 +1,5 @@
 .. -*- rst -*-
 
-=====================================
- OS-FEDERATION IDENTITY PROVIDER API
-=====================================
-
-Provide the ability for users to manage Identity Providers (IdPs). Requires
-v3.0+ of the Identity API.
-
-
 Register an Identity Provider
 =============================
 
diff --git a/api-ref/source/v3-ext/federation/index.inc b/api-ref/source/v3-ext/federation/index.inc
deleted file mode 100644
index 62bbca5790..0000000000
--- a/api-ref/source/v3-ext/federation/index.inc
+++ /dev/null
@@ -1,2 +0,0 @@
-
-.. include:: federation/identity-provider/index.inc
diff --git a/api-ref/source/v3-ext/index.rst b/api-ref/source/v3-ext/index.rst
index 5afd07035a..5cfd4b3157 100644
--- a/api-ref/source/v3-ext/index.rst
+++ b/api-ref/source/v3-ext/index.rst
@@ -12,7 +12,6 @@ This page describes these Identity API v3 extensions:
 * `OS-REVOKE API`_
 * `OS-EP-FILTER API`_
 * `OS-FEDERATION API`_
-* `OS-FEDERATION IDENTITY PROVIDER API`_
 
 .. rest_expand_all::
 
@@ -22,4 +21,3 @@ This page describes these Identity API v3 extensions:
 .. include:: revoke.inc
 .. include:: ep-filter.inc
 .. include:: federation.inc
-.. include:: federation/index.inc