diff --git a/agrest-annotations/src/main/java/io/agrest/annotation/AgResource.java b/agrest-annotations/src/main/java/io/agrest/annotation/AgResource.java
index 5a9ffba8c..f7e766f3d 100644
--- a/agrest-annotations/src/main/java/io/agrest/annotation/AgResource.java
+++ b/agrest-annotations/src/main/java/io/agrest/annotation/AgResource.java
@@ -9,7 +9,9 @@
  * Used to indicate that web method is an Agrest resource.
  *
  * @since 2.10
+ * @deprecated since 4.7, as Agrest now integrates with OpenAPI 3 / Swagger
  */
+@Deprecated
 @Target(ElementType.METHOD)
 @Retention(RetentionPolicy.RUNTIME)
 public @interface AgResource {
diff --git a/agrest-annotations/src/main/java/io/agrest/annotation/LinkType.java b/agrest-annotations/src/main/java/io/agrest/annotation/LinkType.java
index 006509fd6..4186e67a4 100644
--- a/agrest-annotations/src/main/java/io/agrest/annotation/LinkType.java
+++ b/agrest-annotations/src/main/java/io/agrest/annotation/LinkType.java
@@ -4,6 +4,7 @@
  * Classifies endpoints annotated with {@link AgResource}.
  *
  * @since 2.10
+ * @deprecated since 4.7, as Agrest now integrates with OpenAPI 3 / Swagger
  */
 public enum LinkType {
     COLLECTION, ITEM, METADATA, UNDEFINED
diff --git a/agrest-engine/src/test/java/io/agrest/runtime/meta/ResourceParserTest.java b/agrest-engine/src/test/java/io/agrest/runtime/meta/ResourceParserTest.java
index f9c542bd5..6b88adf53 100644
--- a/agrest-engine/src/test/java/io/agrest/runtime/meta/ResourceParserTest.java
+++ b/agrest-engine/src/test/java/io/agrest/runtime/meta/ResourceParserTest.java
@@ -18,6 +18,7 @@
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertThrows;
 
+@Deprecated
 public class ResourceParserTest {
 
     private static ResourceParser resourceParser;