---
# @generated by sylphx-gen 0.1.0 from contracts@3118f36f16f799965338811e17ed3a9f565a9f136b14c95e9c94a1e21d42ea3e. Do not edit.
title: "Agent versions"
description: "The `agent_versions` collection of Sylphx Agents: An AgentVersion is one immutable snapshot of an Agent's definition."
type: reference
product: agents
summary: "An AgentVersion is one immutable snapshot of an Agent's definition."
updated: 2026-09-28
order: 900
---

An AgentVersion is one immutable snapshot of an Agent's definition. It is written by the create or update that changed the Agent's spec, and never changed after.

**Service** Sylphx Agents · **Resource type** `agents.sylphx.com/AgentVersion` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/agents/{agent}/agent_versions/{agent_version}` · **Shape** `record`

**Not available yet.** Sylphx Agents is declared in the registry but no backend serves it: every call answers `501` with the problem code `UNIMPLEMENTED`.

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/agents/{agent}/agent_versions/{agent_version}`. |
| `uid` | `string` | `agv_<cell><ulid>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `version_number` | `int64` | The version number within the agent, from 1, with no gaps. Output only. |
| `spec` | `AgentSpec` | The definition, frozen. Output only. |
| `agent_generation` | `int64` | The Agent generation that minted it. Output only. |
| `create_time` | `timestamp` | When it was minted. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/agent_versions#get) | Gets an agent version. |
| `GET` | [`list`](/docs/api/agent_versions#list) | Lists an agent's versions, newest first. |

## get

Gets an agent version.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agents/agent/agent_versions/agent-version` · scope `agents:read` · effect `read` · not available yet · [Request, response and examples](/docs/api/agent_versions/get)

## list

Lists an agent's versions, newest first.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agents/agent/agent_versions` · scope `agents:read` · effect `read` · not available yet · paginated · [Request, response and examples](/docs/api/agent_versions/list)