diff --git a/api-ref/source/v3/authenticate-v3.inc b/api-ref/source/v3/authenticate-v3.inc
index 7e690c1205..c1543abb76 100644
--- a/api-ref/source/v3/authenticate-v3.inc
+++ b/api-ref/source/v3/authenticate-v3.inc
@@ -90,6 +90,8 @@ Password authentication with unscoped authorization
 
 .. rest_method::  POST /v3/auth/tokens
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_tokens``
+
 Authenticates an identity and generates a token. Uses the password authentication method. Authorization is unscoped.
 
 The request body must include a payload that specifies the
@@ -143,6 +145,8 @@ Password authentication with scoped authorization
 
 .. rest_method::  POST /v3/auth/tokens
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_tokens``
+
 Authenticates an identity and generates a token. Uses the password authentication method and scopes authorization to a project or domain.
 
 The request body must include a payload that specifies the
@@ -205,6 +209,8 @@ Password authentication with explicit unscoped authorization
 
 .. rest_method::  POST /v3/auth/tokens
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_tokens``
+
 Authenticates an identity and generates a token. Uses the password authentication method with explicit unscoped authorization.
 
 The request body must include a payload that specifies the
@@ -259,6 +265,8 @@ Token authentication with unscoped authorization
 
 .. rest_method::  POST /v3/auth/tokens
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_tokens``
+
 Authenticates an identity and generates a token. Uses the token authentication method. Authorization is unscoped.
 
 In the request body, provide the token ID.
@@ -298,6 +306,8 @@ Token authentication with scoped authorization
 
 .. rest_method::  POST /v3/auth/tokens
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_tokens``
+
 Authenticates an identity and generates a token. Uses the token authentication method and scopes authorization to a project or domain.
 
 In the request body, provide the token ID and the ``project`` or
@@ -340,6 +350,8 @@ Validate and show information for token
 
 .. rest_method::  GET /v3/auth/tokens
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_tokens``
+
 Validates and shows information for a token, including its expiration date and authorization scope.
 
 Pass your own token in the ``X-Auth-Token`` request header.
@@ -393,6 +405,8 @@ Check token
 
 .. rest_method::  HEAD /v3/auth/tokens
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_tokens``
+
 Validates a token.
 
 This call is similar to ``GET /auth/tokens`` but no response body
@@ -421,6 +435,8 @@ Revoke token
 
 .. rest_method::  DELETE /v3/auth/tokens
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_tokens``
+
 Revokes a token.
 
 This call is similar to the HEAD ``/auth/tokens`` call except that
@@ -445,6 +461,8 @@ Get service catalog
 
 .. rest_method:: GET /v3/auth/catalog
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_catalog``
+
 New in version 3.3
 
 This call returns a service catalog for the X-Auth-Token provided in the
@@ -486,6 +504,8 @@ Get available project scopes
 
 .. rest_method:: GET /v3/auth/projects
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_projects``
+
 New in version 3.3
 
 This call returns the list of projects that are available to be scoped
@@ -528,6 +548,8 @@ Get available domain scopes
 
 .. rest_method:: GET /v3/auth/domains
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/auth_domains``
+
 New in version 3.3
 
 This call returns the list of domains that are available to be scoped
diff --git a/api-ref/source/v3/credentials.inc b/api-ref/source/v3/credentials.inc
index ee5619e445..2ac4de3f64 100644
--- a/api-ref/source/v3/credentials.inc
+++ b/api-ref/source/v3/credentials.inc
@@ -18,6 +18,8 @@ Create credential
 
 .. rest_method::  POST /v3/credentials
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/credentials``
+
 Creates a credential.
 
 The following example shows how to create an EC2-style credential.
@@ -66,6 +68,8 @@ List credentials
 
 .. rest_method::  GET /v3/credentials
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/credentials``
+
 Lists all credentials.
 
 Optionally, you can include the ``user_id`` query parameter in the
@@ -106,6 +110,8 @@ Show credential details
 
 .. rest_method::  GET /v3/credentials/{credential_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/credential``
+
 Shows details for a credential.
 
 Normal response codes: 200
@@ -143,6 +149,8 @@ Update credential
 
 .. rest_method::  PATCH /v3/credentials/{credential_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/credential``
+
 Updates a credential.
 
 Normal response codes: 200
@@ -191,6 +199,8 @@ Delete credential
 
 .. rest_method::  DELETE /v3/credentials/{credential_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/credential``
+
 Deletes a credential.
 
 Normal response codes: 204
diff --git a/api-ref/source/v3/domains-config-v3.inc b/api-ref/source/v3/domains-config-v3.inc
index 37577a6c83..e3aab7e6d1 100644
--- a/api-ref/source/v3/domains-config-v3.inc
+++ b/api-ref/source/v3/domains-config-v3.inc
@@ -40,6 +40,8 @@ Show domain group option configuration
 
 .. rest_method::  GET /v3/domains/{domain_id}/config/{group}/{option}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_config_default``
+
 Shows details for a domain group option configuration.
 
 The API supports only the ``identity`` and ``ldap`` groups. For the
@@ -82,6 +84,8 @@ Update domain group option configuration
 
 .. rest_method::  PATCH /v3/domains/{domain_id}/config/{group}/{option}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_config_default``
+
 Updates a domain group option configuration.
 
 The API supports only the ``identity`` and ``ldap`` groups. For the
@@ -136,6 +140,8 @@ Delete domain group option configuration
 
 .. rest_method::  DELETE /v3/domains/{domain_id}/config/{group}/{option}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_config_default``
+
 Deletes a domain group option configuration.
 
 The API supports only the ``identity`` and ``ldap`` groups. For the
@@ -160,6 +166,8 @@ Show domain group configuration
 
 .. rest_method::  GET /v3/domains/{domain_id}/config/{group}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_config_default``
+
 Shows details for a domain group configuration.
 
 The API supports only the ``identity`` and ``ldap`` groups.
@@ -199,6 +207,8 @@ Update domain group configuration
 
 .. rest_method::  PATCH /v3/domains/{domain_id}/config/{group}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_config_default``
+
 Updates a domain group configuration.
 
 The API supports only the ``identity`` and ``ldap`` groups. If you
@@ -252,6 +262,8 @@ Delete domain group configuration
 
 .. rest_method::  DELETE /v3/domains/{domain_id}/config/{group}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_config_default``
+
 Deletes a domain group configuration.
 
 The API supports only the ``identity`` and ``ldap`` groups.
@@ -273,6 +285,8 @@ Create domain configuration
 
 .. rest_method::  PUT /v3/domains/{domain_id}/config
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_config``
+
 Creates a domain configuration.
 
 Normal response codes: 200, 201
@@ -321,6 +335,8 @@ Show domain configuration
 
 .. rest_method::  GET /v3/domains/{domain_id}/config
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_config``
+
 Shows details for a domain configuration.
 
 Normal response codes: 200
@@ -357,6 +373,8 @@ Update domain configuration
 
 .. rest_method::  PATCH /v3/domains/{domain_id}/config
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_config``
+
 Updates a domain configuration.
 
 Normal response codes: 200
@@ -405,6 +423,8 @@ Delete domain configuration
 
 .. rest_method::  DELETE /v3/domains/{domain_id}/config
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_config``
+
 Deletes a domain configuration.
 
 Normal response codes: 204
diff --git a/api-ref/source/v3/domains.inc b/api-ref/source/v3/domains.inc
index 1c4e75740c..7b3137c682 100644
--- a/api-ref/source/v3/domains.inc
+++ b/api-ref/source/v3/domains.inc
@@ -28,6 +28,8 @@ List domains
 
 .. rest_method::  GET /v3/domains
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domains``
+
 Lists all domains.
 
 Normal response codes: 200
@@ -65,6 +67,8 @@ Create domain
 
 .. rest_method::  POST /v3/domains
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domains``
+
 Creates a domain.
 
 Normal response codes: 201
@@ -104,6 +108,8 @@ Show domain details
 
 .. rest_method::  GET /v3/domains/{domain_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domains``
+
 Shows details for a domain.
 
 Normal response codes: 200
@@ -140,6 +146,8 @@ Update domain
 
 .. rest_method::  PATCH /v3/domains/{domain_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain``
+
 Updates a domain.
 
 Normal response codes: 200
@@ -186,6 +194,8 @@ Delete domain
 
 .. rest_method::  DELETE /v3/domains/{domain_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain``
+
 Deletes a domain.
 
 To minimize the risk of accidentally deleting a domain, you must
diff --git a/api-ref/source/v3/groups.inc b/api-ref/source/v3/groups.inc
index 9c14e7744b..d7594366bf 100644
--- a/api-ref/source/v3/groups.inc
+++ b/api-ref/source/v3/groups.inc
@@ -25,6 +25,8 @@ Show group details
 
 .. rest_method::  GET /v3/groups/{group_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/group``
+
 Shows details for a group.
 
 Normal response codes: 200
@@ -61,6 +63,8 @@ Update group
 
 .. rest_method::  PATCH /v3/groups/{group_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/group``
+
 Updates a group.
 
 If the back-end driver does not support this functionality, the
@@ -110,6 +114,8 @@ Delete group
 
 .. rest_method::  DELETE /v3/groups/{group_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/group``
+
 Deletes a group.
 
 Error response codes:204,413,415,405,404,403,401,400,503,409,
@@ -127,6 +133,8 @@ Add user to group
 
 .. rest_method::  PUT /v3/groups/{group_id}/users/{user_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/group_user``
+
 Adds a user to a group.
 
 Error response codes:204,413,415,405,404,403,401,400,503,409,
@@ -145,6 +153,8 @@ Remove user from group
 
 .. rest_method::  DELETE /v3/groups/{group_id}/users/{user_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/group_user``
+
 Removes a user from a group.
 
 Normal response codes: 204
@@ -164,6 +174,8 @@ Check whether user belongs to group
 
 .. rest_method::  HEAD /v3/groups/{group_id}/users/{user_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/group_user``
+
 Validates that a user belongs to a group.
 
 Normal response codes: 204
@@ -183,6 +195,8 @@ List users in group
 
 .. rest_method::  GET /v3/groups/{group_id}/users
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/group_users``
+
 Lists the users that belong to a group.
 
 Normal response codes: 200
@@ -207,6 +221,8 @@ Create group
 
 .. rest_method::  POST /v3/groups
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/groups``
+
 Creates a group.
 
 Normal response codes: 201
@@ -251,6 +267,8 @@ List groups
 
 .. rest_method::  GET /v3/groups
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/groups``
+
 Lists groups.
 
 Normal response codes: 200
diff --git a/api-ref/source/v3/policies.inc b/api-ref/source/v3/policies.inc
index 3380eba384..c1a15730ec 100644
--- a/api-ref/source/v3/policies.inc
+++ b/api-ref/source/v3/policies.inc
@@ -27,6 +27,8 @@ Create policy
 
 .. rest_method::  POST /v3/policies
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/policies``
+
 Creates a policy.
 
 Normal response codes: 201
@@ -68,6 +70,8 @@ List policies
 
 .. rest_method::  GET /v3/policies
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/policies``
+
 Lists policies.
 
 Normal response codes: 200
@@ -105,6 +109,8 @@ Show policy details
 
 .. rest_method::  GET /v3/policies/{policy_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/policy``
+
 Shows details for a policy.
 
 Normal response codes: 200
@@ -142,6 +148,8 @@ Update policy
 
 .. rest_method::  PATCH /v3/policies/{policy_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/policy``
+
 Updates a policy.
 
 Normal response codes: 200
@@ -190,6 +198,8 @@ Delete policy
 
 .. rest_method::  DELETE /v3/policies/{policy_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/policy``
+
 Deletes a policy.
 
 Normal response codes: 204
diff --git a/api-ref/source/v3/projects.inc b/api-ref/source/v3/projects.inc
index 6c55f237cc..f1f3e0ce8e 100644
--- a/api-ref/source/v3/projects.inc
+++ b/api-ref/source/v3/projects.inc
@@ -32,6 +32,8 @@ List projects
 
 .. rest_method::  GET /v3/projects
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/projects``
+
 Lists projects.
 
 Normal response codes: 200
@@ -76,6 +78,8 @@ Create project
 
 .. rest_method::  POST /v3/projects
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/projects``
+
 Creates a project, including a project acting as a domain.
 
 Normal response codes: 201
@@ -124,6 +128,8 @@ Show project details
 
 .. rest_method::  GET /v3/projects/{project_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project``
+
 Shows details for a project.
 
 Normal response codes: 200
@@ -179,6 +185,8 @@ Update project
 
 .. rest_method::  PATCH /v3/projects/{project_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project``
+
 Updates a project.
 
 Normal response codes: 200
@@ -230,6 +238,8 @@ Delete project
 
 .. rest_method::  DELETE /v3/projects/{project_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project``
+
 Deletes a project.
 
 Normal response codes: 204
@@ -248,6 +258,8 @@ Enable or disable project and its subtree
 
 .. rest_method::  PATCH /v3/projects/{project_id}/cascade
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project``
+
 (Since Identity API v3.7) Enables or disables a project and its entire subtree.
 
 A project subtree includes all projects beneath the parent project
@@ -306,6 +318,8 @@ Delete project subtree
 
 .. rest_method::  DELETE /v3/projects/{project_id}/cascade
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project``
+
 (Since Identity API v3.7) Deletes a project and its entire subtree.
 
 A project subtree includes all projects beneath the parent project
diff --git a/api-ref/source/v3/regions-v3.inc b/api-ref/source/v3/regions-v3.inc
index 9bb0e24827..d27bcfdca6 100644
--- a/api-ref/source/v3/regions-v3.inc
+++ b/api-ref/source/v3/regions-v3.inc
@@ -20,6 +20,8 @@ Show region details
 
 .. rest_method::  GET /v3/regions/{region_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/regions``
+
 Shows details for a region, by ID.
 
 Normal response codes: 200
@@ -55,6 +57,8 @@ Update region
 
 .. rest_method::  PATCH /v3/regions/{region_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/region``
+
 Updates a region.
 
 You can update the description or parent region ID for a region.
@@ -106,6 +110,8 @@ Delete region
 
 .. rest_method::  DELETE /v3/regions/{region_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/region``
+
 Deletes a region.
 
 The following error might occur:
@@ -129,6 +135,8 @@ List regions
 
 .. rest_method::  GET /v3/regions
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/regions``
+
 Lists regions.
 
 Normal response codes: 200
@@ -164,6 +172,8 @@ Create region
 
 .. rest_method::  POST /v3/regions
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/regions``
+
 Creates a region.
 
 When you create the region, you can optionally specify a region ID.
diff --git a/api-ref/source/v3/roles.inc b/api-ref/source/v3/roles.inc
index 925a9dcf25..76df971293 100644
--- a/api-ref/source/v3/roles.inc
+++ b/api-ref/source/v3/roles.inc
@@ -83,6 +83,8 @@ Assign role to group on project
 
 .. rest_method::  PUT /v3/projects/{project_id}/groups/{group_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project_group_role``
+
 Assigns a role to a group on a project.
 
 Normal response codes: 204
@@ -103,6 +105,8 @@ Check whether group has role assignment on project
 
 .. rest_method::  HEAD /v3/projects/{project_id}/groups/{group_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project_group_role``
+
 Validates that a group has a role assignment on a project.
 
 Normal response codes: 204
@@ -123,6 +127,8 @@ Unassign role from group on project
 
 .. rest_method::  DELETE /v3/projects/{project_id}/groups/{group_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project_group_role``
+
 Unassigns a role from a group on a project.
 
 Normal response codes: 204
@@ -143,6 +149,8 @@ Assign role to user on project
 
 .. rest_method::  PUT /v3/projects/{project_id}/users/{user_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project_user_role``
+
 Assigns a role to a user on a project.
 
 Normal response codes: 204
@@ -163,6 +171,8 @@ Check whether user has role assignment on project
 
 .. rest_method::  HEAD /v3/projects/{project_id}/users/{user_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project_user_role``
+
 Validates that a user has a role on a project.
 
 Normal response codes: 204
@@ -183,6 +193,8 @@ Unassign role from user on project
 
 .. rest_method::  DELETE /v3/projects/{project_id}/users/{user_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project_user_role``
+
 Unassigns a role from a user on a project.
 
 Normal response codes: 204
@@ -203,6 +215,8 @@ List role assignments for user on project
 
 .. rest_method::  GET /v3/projects/{project_id}/users/{user_id}/roles
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project_user_role``
+
 Lists role assignments for a user on a project.
 
 Normal response codes: 200
@@ -228,6 +242,8 @@ List role assignments for group on project
 
 .. rest_method::  GET /v3/projects/{project_id}/groups/{group_id}/roles
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/project_user_role``
+
 Lists role assignments for a group on a project.
 
 Normal response codes: 200
@@ -258,6 +274,8 @@ Assign role to group on domain
 
 .. rest_method::  PUT /v3/domains/{domain_id}/groups/{group_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_group_role``
+
 Assigns a role to a group on a domain.
 
 Normal response codes: 204
@@ -277,6 +295,8 @@ Check whether group has role assignment on domain
 
 .. rest_method::  HEAD /v3/domains/{domain_id}/groups/{group_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_group_role``
+
 Validates that a group has a role assignment on a domain.
 
 Normal response codes: 204
@@ -297,6 +317,8 @@ Unassign role from group on domain
 
 .. rest_method::  DELETE /v3/domains/{domain_id}/groups/{group_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_group_role``
+
 Unassigns a role from a group on a domain.
 
 Normal response codes: 204
@@ -317,6 +339,8 @@ List role assignments for user on domain
 
 .. rest_method::  GET /v3/domains/{domain_id}/users/{user_id}/roles
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_user_roles``
+
 Lists role assignments for a user on a domain.
 
 Normal response codes: 200
@@ -357,6 +381,8 @@ List roles
 
 .. rest_method::  GET /v3/roles
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/roles``
+
 Lists roles.
 
 Normal response codes: 200
@@ -392,6 +418,8 @@ Create role
 
 .. rest_method::  POST /v3/roles
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/roles``
+
 Creates a role.
 
 Normal response codes: 201
@@ -427,6 +455,8 @@ Assign role to user on domain
 
 .. rest_method::  PUT /v3/domains/{domain_id}/users/{user_id}/roles/{role_id}
 
+Relationship: ``http://developer.openstack.org/api-ref-identity-v3.html#assignRoleToUser-domain``
+
 Assigns a role to a user on a domain.
 
 Normal response codes: 204
@@ -447,6 +477,8 @@ Check whether user has role assignment on domain
 
 .. rest_method::  HEAD /v3/domains/{domain_id}/users/{user_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_user_role``
+
 Validates that a user has a role assignment on a domain.
 
 Normal response codes: 204
@@ -467,6 +499,8 @@ Unassigns role from user on domain
 
 .. rest_method::  DELETE /v3/domains/{domain_id}/users/{user_id}/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_user_role``
+
 Unassigns a role from a user on a domain.
 
 Normal response codes: 204
@@ -487,6 +521,8 @@ List role assignments
 
 .. rest_method::  GET /v3/role_assignments
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/role_assignments``
+
 Lists role assignments.
 
 Normal response codes: 200
@@ -525,6 +561,8 @@ Show role details
 
 .. rest_method::  GET /v3/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/role``
+
 Shows details for a role.
 
 Normal response codes: 200
@@ -559,6 +597,8 @@ Update role
 
 .. rest_method::  PATCH /v3/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/role``
+
 Updates a role.
 
 Normal response codes: 200
@@ -601,6 +641,8 @@ Delete role
 
 .. rest_method::  DELETE /v3/roles/{role_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/role``
+
 Deletes a role.
 
 Normal response codes: 204
@@ -619,6 +661,8 @@ List role assignments for group on domain
 
 .. rest_method::  GET /v3/domains/{domain_id}/groups/{group_id}/roles
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/domain_group_roles``
+
 Lists role assignments for a group on a domain.
 
 Normal response codes: 200
diff --git a/api-ref/source/v3/service-catalog.inc b/api-ref/source/v3/service-catalog.inc
index c34b2c4d2b..b3b4ece5d8 100644
--- a/api-ref/source/v3/service-catalog.inc
+++ b/api-ref/source/v3/service-catalog.inc
@@ -24,6 +24,8 @@ List services
 
 .. rest_method::  GET /v3/services
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/services``
+
 Lists all services.
 
 Normal response codes: 200
@@ -61,6 +63,8 @@ Create service
 
 .. rest_method::  POST /v3/services
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/services``
+
 Creates a service.
 
 Normal response codes: 201
@@ -102,6 +106,8 @@ Show endpoint details
 
 .. rest_method::  GET /v3/endpoints/{endpoint_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/endpoints``
+
 Shows details for an endpoint.
 
 Normal response codes: 200
@@ -139,6 +145,8 @@ Update endpoint
 
 .. rest_method::  PATCH /v3/endpoints/{endpoint_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/endpoint``
+
 Updates an endpoint.
 
 Normal response codes: 200
@@ -187,6 +195,8 @@ Delete endpoint
 
 .. rest_method::  DELETE /v3/endpoints/{endpoint_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/endpoint``
+
 Deletes an endpoint.
 
 Normal response codes: 204
@@ -205,6 +215,8 @@ List endpoints
 
 .. rest_method::  GET /v3/endpoints
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/endpoints``
+
 Lists all available endpoints.
 
 Normal response codes: 200
@@ -245,6 +257,8 @@ Create endpoint
 
 .. rest_method::  POST /v3/endpoints
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/endpoints``
+
 Creates an endpoint.
 
 Normal response codes: 201
@@ -289,6 +303,8 @@ Show service details
 
 .. rest_method::  GET /v3/services/{service_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/service``
+
 Shows details for a service.
 
 Normal response codes: 200
@@ -325,6 +341,8 @@ Update service
 
 .. rest_method::  PATCH /v3/services/{service_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/services``
+
 Updates a service.
 
 The request body is the same as the create service request body,
@@ -376,6 +394,8 @@ Delete service
 
 .. rest_method::  DELETE /v3/services/{service_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/service``
+
 Deletes a service.
 
 If you try to delete a service that still has associated endpoints,
diff --git a/api-ref/source/v3/users.inc b/api-ref/source/v3/users.inc
index bfb641bdc5..5fdeef80e4 100644
--- a/api-ref/source/v3/users.inc
+++ b/api-ref/source/v3/users.inc
@@ -22,6 +22,8 @@ Show user details
 
 .. rest_method::  GET /v3/users/{user_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/user``
+
 Shows details for a user.
 
 Normal response codes: 200
@@ -60,6 +62,8 @@ Update user
 
 .. rest_method::  PATCH /v3/users/{user_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/user``
+
 Updates a user's password, or whether they are enabled or
 disabled.
 
@@ -114,6 +118,8 @@ Delete user
 
 .. rest_method::  DELETE /v3/users/{user_id}
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/user``
+
 Deletes a user.
 
 Error response codes:204,413,415,405,404,403,401,400,503,409,
@@ -131,6 +137,8 @@ List groups to which a user belongs
 
 .. rest_method::  GET /v3/users/{user_id}/groups
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/user_groups``
+
 Lists groups to which a user belongs.
 
 Normal response codes: 200
@@ -155,6 +163,8 @@ Change password for user
 
 .. rest_method::  POST /v3/users/{user_id}/password
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/user_change_password``
+
 Changes the password for a user.
 
 Error response codes:204,413,415,405,404,403,401,400,503,409,
@@ -181,6 +191,8 @@ Create user
 
 .. rest_method::  POST /v3/users
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/users``
+
 Creates a user.
 
 Error response codes:201,413,415,405,404,403,401,400,503,409,
@@ -223,6 +235,8 @@ List users
 
 .. rest_method::  GET /v3/users
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/users``
+
 Lists users.
 
 Normal response codes: 200
@@ -264,6 +278,8 @@ List projects for user
 
 .. rest_method::  GET /v3/users/{user_id}/projects
 
+Relationship: ``http://docs.openstack.org/api/openstack-identity/3/rel/user_projects``
+
 List projects for a user.
 
 Normal response codes: 200