---
title: "AgentVersion"
description: "The `AgentVersion` entity."
section: "Reference"
group: "Types"
order: 8
---

## Definition

```ts
interface AgentVersion {
  id: string;
  agentId: 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;
  createdAt: string;
  updatedAt: string;
}
```

## Fields

| Field            | Type                                                                                                                                                                 | Notes                                                                        |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| `id`             | `string`                                                                                                                                                             | `readonly` `required`                                                        |
| `agentId`        | `string`                                                                                                                                                             | `required` — Agent 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 used when the agent runs this version.            |
| `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 the agent may use, in preference order.               |
| `inputSchemaId`  | `string \| null`                                                                                                                                                     | `required` — Structured-input schema enforced on run inputs, if any.         |
| `outputSchemaId` | `string \| null`                                                                                                                                                     | `required` — Structured-output schema the agent is asked to produce.         |
| `createdAt`      | `string`                                                                                                                                                             | `readonly` `required` — ISO-8601 timestamp of creation.                      |
| `updatedAt`      | `string`                                                                                                                                                             | `readonly` `required` — ISO-8601 timestamp of the last update.               |