> ## 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.

# children()

> `protected` **children**(): `Promise`\<[`ChildRef`](/docs/agent-sdk/interface/children#childref)\[]>

The children this agent has, as the platform records them.

The list is read from the platform every time, not from anything this
agent wrote down. That is the point: a parent that crashed after creating
three workers and came back remembering nothing still enumerates all
three, because the record of who belongs to whom never lived in the
parent's state in the first place. There is no registry to keep in sync,
and none to lose.

Children can be of different types, so what comes back are descriptors
rather than stubs — one class cannot type them all. Each carries the name
the child is addressed by, so turning one into a live handle is the
ordinary binding call:

```ts theme={null}
for (const child of await this.children()) {
  if (child.type !== "Worker") continue;
  await this.env.WORKER.idFromName(child.name).ping();
}
```

An agent with no children gets an empty array, not an error.

Added with SDK 0.15 — a new inherited member, so a subclass that already
declares `children` must rename it (or align it to override this method).

**Returns**

`Promise`\<[`ChildRef`](/docs/agent-sdk/interface/children#childref)\[]>

Every child attached to this agent, of every type.

## ChildRef

One child of an agent, as the platform records it.

A descriptor, not a handle: children of one parent can be of different
types, so there is no single class to type a stub against. Turn one into a
live handle with the binding for its type —
`env.<BINDING>.idFromName(child.name)`.

**Properties**

**createdAt**

> `readonly` **createdAt**: `Date`

When the child was created.

***

**name**

> `readonly` **name**: `string`

The child's address — the same string `env.<BINDING>.idFromName(...)`
takes, so a descriptor becomes a callable stub without translation.

***

**status**

> `readonly` **status**: `string`

The child's lifecycle status as the platform reports it.

***

**type**

> `readonly` **type**: `string`

The actor type the child runs as, e.g. `"Worker"`.