SwarmVersion

The `SwarmVersion` entity.

Definition

TypeScript

interface SwarmVersion {
  id: string;
  swarmId: string;
  name: string;
  parentId: string | null;
  instructions: string;
  models: Array<
    | "anthropic/claude-opus-4-6"
    | "anthropic/claude-sonnet-4-6"
    | "anthropic/claude-haiku-4-5"
    | "openai/gpt-5.4"
    | "openai/gpt-4o"
    | "openai/gpt-4o-mini"
  >;
  inputSchemaId: string | null;
  outputSchemaId: string | null;
  entryNodeId: string | null;
  createdAt: string;
  updatedAt: string;
}

Fields

Field	Type	Notes
`id`	`string`	`readonly` `required`
`swarmId`	`string`	`required` — Swarm this version belongs to.
`name`	`string`	`required` — Version label (e.g. 'v1', 'experiment').
`parentId`	`string \| null`	`required` — Version this one was forked from; null for the initial version.
`instructions`	`string`	`required` — System prompt shared across all nodes in the swarm.
`models`	`Array<"anthropic/claude-opus-4-6" \| "anthropic/claude-sonnet-4-6" \| "anthropic/claude-haiku-4-5" \| "openai/gpt-5.4" \| "openai/gpt-4o" \| "openai/gpt-4o-mini">`	`required` — Model IDs available to swarm nodes, in preference order.
`inputSchemaId`	`string \| null`	`required` — Schema enforced on input to the entry node.
`outputSchemaId`	`string \| null`	`required` — Schema expected for the swarm's final output.
`entryNodeId`	`string \| null`	`required` — Node where execution begins; null until nodes are added.
`createdAt`	`string`	`readonly` `required` — ISO-8601 timestamp of creation.
`updatedAt`	`string`	`readonly` `required` — ISO-8601 timestamp of the last update.