---
title: "Durable Objects"
description: "Durable Objects provide persistent state for edge deployed agents. Each agent instance gets its own isolated storage that persists across requests. Cloudflare Durable Objects are: Stateful — maintain state between reques"
resource: https://www.aiagents.nexus/docs/edge/durable-objects
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Durable Objects

Durable Objects provide persistent state for edge-deployed agents. Each agent instance gets its own isolated storage that persists across requests.

## What Are Durable Objects?

Cloudflare Durable Objects are:
- **Stateful** — maintain state between requests
- **Consistent** — strong consistency guarantees
- **Global** — automatically placed near users
- **Isolated** — each instance is independent

## How Nexus OS Uses Them

When you deploy an agent to the edge, Nexus OS automatically creates a Durable Object namespace for it:

```
Agent (WASM) → Cloudflare Worker → Durable Object (state)
```

The agent can read and write state that persists across invocations:

```
Request 1: agent processes task, saves state
Request 2: agent reads previous state, continues work
```

## Enabling Durable Objects

```yaml
edge:
  provider: cloudflare
  durableObjects: true
```

## State API

Edge-deployed agents can use these state functions:

| Function | Description |
|---|---|
| `state_get(key)` | Read a value from persistent storage |
| `state_put(key, value)` | Write a value to persistent storage |
| `state_delete(key)` | Delete a value from storage |
| `state_list(prefix)` | List keys with a given prefix |

## Limitations

| Limit | Value |
|---|---|
| Storage per object | 256KB (free) / 10GB (paid) |
| Request duration | 30 seconds |
| Concurrent requests | Serialized per object |
| Objects per namespace | Unlimited |