---
title: "AddSwarmNodeBody"
description: "Request body for a SwarmNode operation."
section: "Reference"
group: "Types"
order: 220
---

## Definition

```ts
interface AddSwarmNodeBody {
  swarmVersionId: string;
  agentId: string;
  agentVersionId?: string | undefined;
}
```

## Fields

| Field            | Type                  | Notes                                                                                |
| ---------------- | --------------------- | ------------------------------------------------------------------------------------ |
| `swarmVersionId` | `string`              | `required` — Swarm version to add the node to.                                       |
| `agentId`        | `string`              | `required` — Agent to place at this node                                             |
| `agentVersionId` | `string \| undefined` | `optional` — Specific agent version to use. Omit to use the agent's default version. |