AgentVersion

The `AgentVersion` entity.

Definition

TypeScript

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.