diff --git a/api-ref/source/v3-ext/federation/projects-domains/parameters.yaml b/api-ref/source/v3-ext/federation/projects-domains/parameters.yaml
new file mode 100644
index 0000000000..1633caf040
--- /dev/null
+++ b/api-ref/source/v3-ext/federation/projects-domains/parameters.yaml
@@ -0,0 +1,35 @@
+# variables in header
+
+# variables in path
+
+# variables in query
+
+# variables in body
+
+domains:
+  description: |
+    The list of domains the authenticated user may scope to
+  in: body
+  required: true
+  type: object
+
+links_domains:
+  description: |
+    Link to the URI where the domain collection is located
+  in: body
+  required: true
+  type: object
+
+links_projects:
+  description: |
+    Link to the URI where the project collection is located
+  in: body
+  required: true
+  type: object
+
+projects:
+  description: |
+    The list of projects the authenticated user may scope to
+  in: body
+  required: true
+  type: object
diff --git a/api-ref/source/v3-ext/federation/projects-domains/projects-domains.inc b/api-ref/source/v3-ext/federation/projects-domains/projects-domains.inc
index 823a8796d8..957d72108e 100644
--- a/api-ref/source/v3-ext/federation/projects-domains/projects-domains.inc
+++ b/api-ref/source/v3-ext/federation/projects-domains/projects-domains.inc
@@ -18,6 +18,14 @@ to access. To access this resource, an unscoped token is used, the user can
 then select a project and request a scoped token. Note that only enabled
 projects will be returned.
 
+Response
+--------
+
+.. rest_parameters:: federation/projects-domains/parameters.yaml
+
+   - links: links_projects
+   - projects: projects
+
 Response Example
 ----------------
 
@@ -40,6 +48,14 @@ to access. To access this resource, an unscoped token is used, the user can
 then select a domain and request a scoped token. Note that only enabled domains
 will be returned.
 
+Response
+--------
+
+.. rest_parameters:: federation/projects-domains/parameters.yaml
+
+   - domains: domains
+   - links: links_domains
+
 Response Example
 ----------------