---
title: "SwarmNode"
description: "The `SwarmNode` entity."
section: "Reference"
group: "Types"
order: 219
---

## Definition

```ts
interface SwarmNode {
  id: string;
  swarmVersionId: string;
  agentId: string;
  agentVersionId: string | null;
}
```

## Fields

| Field            | Type             | Notes                                                                                            |
| ---------------- | ---------------- | ------------------------------------------------------------------------------------------------ |
| `id`             | `string`         | `readonly` `required`                                                                            |
| `swarmVersionId` | `string`         | `required` — Swarm version this node belongs to.                                                 |
| `agentId`        | `string`         | `required` — Agent placed at this node.                                                          |
| `agentVersionId` | `string \| null` | `required` — Specific agent version pinned on this node; null falls back to the agent's default. |