diff --git a/packages/core/types/src/index.ts b/packages/core/types/src/index.ts
index 5d5194a1ff..5d9134aaa0 100644
--- a/packages/core/types/src/index.ts
+++ b/packages/core/types/src/index.ts
@@ -111,6 +111,10 @@ export interface Strapi extends Container {
    * @deprecated will be removed in the next major
    */
   entityService?: EntityService.EntityService;
+  /**
+   * @description interact with documents within Strapi, this API is currently in beta and is subject to change in the future
+   * @beta
+   */
   documents?: Documents.Service;
   telemetry: TelemetryService;
   requestContext: RequestContext;