Document raw Containers API alongside Container class

public/__redirects

@@ -627,10 +627,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
@@ -642,16 +646,17 @@
 # Containers IA rework: platform-details/ dissolved into core sections
 /containers/platform-details/architecture/ /containers/concepts/architecture/ 301
 /containers/platform-details/placement/ /containers/concepts/placement/ 301
-/containers/platform-details/outbound-traffic/ /containers/guides/outbound-traffic/ 301
+/containers/platform-details/outbound-traffic/ /containers/configuration/outbound-traffic/ 301
 /containers/platform-details/workers-connections/ /containers/configuration/workers-connections/ 301
 /containers/platform-details/environment-variables/ /containers/configuration/environment-variables/ 301
 /containers/platform-details/rollouts/ /containers/configuration/rollouts/ 301
 /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
 /containers/reference/local-dev/ /containers/guides/local-dev/ 301
 /containers/reference/environment-variables/ /containers/configuration/environment-variables/ 301
 /containers/reference/scaling-and-routing/ /containers/configuration/scaling-and-routing/ 301

src/content/changelog/containers/2026-03-26-outbound-workers.mdx

@@ -78,4 +78,4 @@ This provides an easy way to associate state with any container instance, and in
 
 Upgrade to `@cloudflare/containers` version 0.2.0 or later, or `@cloudflare/sandbox` version 0.8.0 or later to use outbound Workers.
 
-Refer to [Containers outbound traffic](/containers/guides/outbound-traffic/) and [Sandboxes outbound traffic](/sandbox/guides/outbound-traffic/) for more details and examples.
+Refer to [Containers outbound traffic](/containers/configuration/outbound-traffic/) and [Sandboxes outbound traffic](/sandbox/guides/outbound-traffic/) for more details and examples.

src/content/changelog/containers/2026-04-13-sandbox-outbound-workers-tls-auth.mdx

@@ -109,4 +109,4 @@ Handlers accept `params`, so you can customize behavior per instance without def
 
 Upgrade to `@cloudflare/containers@0.3.0` or `@cloudflare/sandbox@0.8.9` to use these features.
 
-For more details, refer to [Sandbox outbound traffic](/sandbox/guides/outbound-traffic/) and [Container outbound traffic](/containers/guides/outbound-traffic/).
+For more details, refer to [Sandbox outbound traffic](/sandbox/guides/outbound-traffic/) and [Container outbound traffic](/containers/configuration/outbound-traffic/).

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

@@ -1,16 +1,16 @@
 ---
 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 higher-level Container class built on Durable Objects.
 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/).
 
 **`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.
 
@@ -102,7 +102,7 @@ Configure these as class fields on your subclass. They apply to every instance o
   `true`) — controls whether the container can make outbound HTTP requests. Set
   to `false` for sandboxed environments where you want to intercept or block all
   outbound traffic. For more information, refer to [Handle outbound
-  traffic](/containers/guides/outbound-traffic/).
+  traffic](/containers/configuration/outbound-traffic/).
 
 - <span id="pingendpoint"></span>**`pingEndpoint`** (`string`, default:
   `"ping"`) — the host and path the class uses to health-check the container
@@ -719,7 +719,7 @@ export default {
 ```
 </TypeScriptExample>
 
-For more information, refer to [Handle outbound traffic](/containers/guides/outbound-traffic/).
+For more information, refer to [Handle outbound traffic](/containers/configuration/outbound-traffic/).
 
 ## Utility functions