Document raw Containers API alongside Container class

public/__redirects

@@ -641,10 +641,14 @@
 /constellation/ /workers-ai/ 301
 # Containers
 /containers/beta-info/ /containers/faq/ 301
-/containers/container-package/ /containers/reference/container-class/ 301
-/containers/durable-object-methods/ /durable-objects/api/container/ 301
+# Containers API
+/containers/container-package/ /containers/api/container-class/ 301
+/containers/durable-object-methods/ /containers/api/durable-object-container/ 301
+/containers/container-class/ /containers/api/container-class/ 301
+/containers/reference/container-class/ /containers/api/container-class/ 301
+/containers/reference/durable-object-methods/ /containers/api/durable-object-container/ 301
+/durable-objects/api/container/ /containers/api/durable-object-container/ 301
 # Containers IA rework: loose pages folded into core sections
-/containers/container-class/ /containers/reference/container-class/ 301
 /containers/local-dev/ /containers/guides/local-dev/ 301
 /containers/deploy/ /containers/guides/deploy/ 301
 /containers/execute-commands/ /containers/guides/execute-commands/ 301
@@ -663,7 +667,7 @@
 /containers/platform-details/scaling-and-routing/ /containers/configuration/scaling-and-routing/ 301
 /containers/platform-details/limits/ /containers/platform/limits/ 301
 /containers/platform-details/image-management/ /containers/guides/image-management/ 301
-/containers/platform-details/durable-object-methods/ /durable-objects/api/container/ 301
+/containers/platform-details/durable-object-methods/ /containers/api/durable-object-container/ 301
 /containers/platform-details/ /containers/concepts/architecture/ 301
 # Containers IA rework: Configuration section + Local Development to Guides + Wrangler pages to Reference
 /containers/guides/outbound-traffic/ /containers/configuration/outbound-traffic/ 301

src/content/docs/containers/reference/container-class.mdx → src/content/docs/containers/api/container-class.mdx

@@ -1,16 +1,18 @@
 ---
 pcx_content_type: reference
-title: Container Interface
+title: Container class
 sidebar:
-  order: 1
-description: API reference for the Container interface and utility functions
+  order: 2
+description: API reference for the Container class and its built-in lifecycle helpers.
 products:
   - containers
 ---
 
 import { PackageManagers, TypeScriptExample } from "~/components";
 
-The [`Container` class](https://github.com/cloudflare/containers) from [`@cloudflare/containers`](https://www.npmjs.com/package/@cloudflare/containers) is the most common way to interact with container instances from a Worker.
+The [`Container` class](https://github.com/cloudflare/containers) from [`@cloudflare/containers`](https://www.npmjs.com/package/@cloudflare/containers) provides lifecycle helpers for container instances. For direct lifecycle control, use the [Durable Object Container API](/containers/api/durable-object-container/).
+
+To move an existing application to direct control, refer to [Migrate to the Durable Object Container API](/containers/guides/migrate-to-durable-object-container-api/).
 
 **`Container` extends [`DurableObject`](/durable-objects/api/base/).** The Durable Object manages routing, persistent state, and lifecycle hooks, while the container process runs your image inside a Linux VM. Because your subclass is a Durable Object, you have access to the full Durable Object API — including [`this.ctx.storage`](/durable-objects/api/sqlite-storage-api/) for persistent SQLite-backed storage and [`this.ctx.id`](/durable-objects/api/id/) for the unique instance identifier. Use Durable Object storage to persist state that should survive container restarts, such as configuration, user data, or task results.