Skip to content
Console
Menu

Getting Started

Authentication

KV Store

Agent versions

An AgentVersion is one immutable snapshot of an Agent's definition.

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

FieldTypeWhat it is
namestringorgs/{org}/projects/{project}/envs/{env}/agents/{agent}/agent_versions/{agent_version}.
uidstringagv_<cell><ulid>; never reused. Output only.
metaResourceMetaResource metadata.
version_numberint64The version number within the agent, from 1, with no gaps. Output only.
specAgentSpecThe definition, frozen. Output only.
agent_generationint64The Agent generation that minted it. Output only.
create_timetimestampWhen 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.

MethodCallWhat it does
GETgetGets an agent version.
GETlistLists 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

#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