diff --git a/doc/api/discussions.md b/doc/api/discussions.md
index 4a43a9913d9dc68224c36ade08f9ee6e807b2198..b1df44b2cdf8b5f498bf723cfa95cbd01c1c7796 100644
--- a/doc/api/discussions.md
+++ b/doc/api/discussions.md
@@ -480,6 +480,11 @@ DETAILS:
 **Tier:** Ultimate
 **Offering:** GitLab.com, Self-managed, GitLab Dedicated
 
+WARNING:
+The Epics REST API was [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/460668) in GitLab 17.0
+and is planned for removal in v5 of the API. Use the [Work Items API](https://handbook.gitlab.com/handbook/engineering/architecture/design-documents/work_items/) instead.
+This change is a breaking change.
+
 ### List group epic discussion items
 
 Gets a list of all discussion items for a single epic.
diff --git a/doc/api/epic_issues.md b/doc/api/epic_issues.md
index 964cbd251f30cf2b67f9da22160a705e63a7f32f..839ada08ee268fbf9b8bfc2fade603199c5121c6 100644
--- a/doc/api/epic_issues.md
+++ b/doc/api/epic_issues.md
@@ -10,6 +10,11 @@ DETAILS:
 **Tier:** Premium, Ultimate
 **Offering:** GitLab.com, Self-managed, GitLab Dedicated
 
+WARNING:
+The Epics REST API was [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/460668) in GitLab 17.0
+and is planned for removal in v5 of the API. Use the [Work Items API](https://handbook.gitlab.com/handbook/engineering/architecture/design-documents/work_items/) instead.
+This change is a breaking change.
+
 Every API call to the epic issues API endpoint must be authenticated.
 
 If a user is not a member of a group and the group is private, a `GET` request on that group
diff --git a/doc/api/epic_links.md b/doc/api/epic_links.md
index 822f4d7bf8660f6a35c49c796c3febd9c517a89e..0af1ce12318b7669a3518b67c0d2d568cd9411f2 100644
--- a/doc/api/epic_links.md
+++ b/doc/api/epic_links.md
@@ -10,6 +10,11 @@ DETAILS:
 **Tier:** Ultimate
 **Offering:** GitLab.com, Self-managed, GitLab Dedicated
 
+WARNING:
+The Epics REST API was [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/460668) in GitLab 17.0
+and is planned for removal in v5 of the API. Use the [Work Items API](https://handbook.gitlab.com/handbook/engineering/architecture/design-documents/work_items/) instead.
+This change is a breaking change.
+
 Manages parent-child [epic relationships](../user/group/epics/manage_epics.md#multi-level-child-epics).
 
 Every API call to `epic_links` must be authenticated.
diff --git a/doc/api/linked_epics.md b/doc/api/linked_epics.md
index 2a5cce7968ea94c4381d14ec4555b53e2109be8b..34cafc0f1d25314720c54ccf37b972d1249d1f76 100644
--- a/doc/api/linked_epics.md
+++ b/doc/api/linked_epics.md
@@ -13,6 +13,11 @@ DETAILS:
 > - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/352493) in GitLab 14.9 [with a flag](../administration/feature_flags.md) named `related_epics_widget`. Enabled by default.
 > - [Feature flag `related_epics_widget`](https://gitlab.com/gitlab-org/gitlab/-/issues/357089) removed in GitLab 15.0.
 
+WARNING:
+The Epics REST API was [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/460668) in GitLab 17.0
+and is planned for removal in v5 of the API. Use the [Work Items API](https://handbook.gitlab.com/handbook/engineering/architecture/design-documents/work_items/) instead.
+This change is a breaking change.
+
 If the Related Epics feature is not available in your GitLab plan, a `403` status code is returned.
 
 ## List related epic links from a group