> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> The telnyx.toml [[actors]] block that declares an actor binding — binding (the env property) and type (the class to instantiate per name).

A Stateful Actor project uses the umbrella `telnyx.toml` manifest (the same file your `[[secrets]]` and `[telnyx]` bindings live in). The actor declaration is a `[[actors]]` array:

```toml theme={null}
name = "account"                # function name
main = "src/index.ts"          # entry — exports the fetch handler (and the class, if this func owns the type)
compatibility_date = "2026-05-01"

[[actors]]
binding = "ACCOUNT"           # the property on env — your handle
type    = "Account"           # the class to instantiate per name
```

| Field                | Meaning                                                                                                                                                                                                |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `name`               | Function name (used by the platform to register the func)                                                                                                                                              |
| `main`               | Entry module — exports the `default { fetch }` handler, plus the actor class when this function owns the type (a [reference binding](/docs/edge-compute/stateful-actors/shared-actors) ships no class) |
| `compatibility_date` | Runtime compatibility pin                                                                                                                                                                              |
| `[[actors]] binding` | The name you'll use as `env.<binding>` from your function                                                                                                                                              |
| `[[actors]] type`    | The class name to instantiate per actor name                                                                                                                                                           |

Constraints, enforced at ship time: `binding` and `type` must be identifiers and must
not contain `__`; `type` is capped at 32 characters; binding names must be unique
across all bindings in the file, and `SECRETS` is reserved as a binding name when the
file has a `[[secrets]]` block. Multiple `[[actors]]` blocks are allowed — including
two bindings pointing at the same `type`.

## Related

* [Actor Namespace](/docs/edge-compute/stateful-actors/api-reference/namespace) — the `env.<binding>` this declares
* [Project Structure](/docs/edge-compute/stateful-actors/guides/project-structure) — the two-export project shape