versions

Creates, updates, deletes, gets or lists a versions resource.

Overview

Name	versions
Type	Resource
Id	anthropic.agents.versions

Fields

The following fields are returned by SELECT queries:

list

Successful response (OK)

Name	Datatype	Description
id	string
name	string
archived_at	string (date-time)	When the agent was archived. Null if not archived.
created_at	string (date-time)	A timestamp in RFC 3339 format
description	string
▶mcp_servers	array
metadata	object
▶model	object	Model identifier and configuration.
▶multiagent	object	Multiagent orchestration configuration. Null when the agent is single-threaded.
▶skills	array
system	string
▶tools	array
type	string	(agent)
updated_at	string (date-time)	A timestamp in RFC 3339 format
version	integer (int32)	The agent's current version. Starts at 1 and increments when the agent is modified.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	agent_id	anthropic-workspace-id

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
agent_id	string	Path parameter agent_id (example: agent_011CZkYpogX7uDKUyvBTophP)
anthropic-workspace-id	string	Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. (example: wrkspc_011CZkZaBF1tNoB5wlCeusgy)

SELECT examples

list

Successful response (OK)

SELECT
id,
name,
archived_at,
created_at,
description,
mcp_servers,
metadata,
model,
multiagent,
skills,
system,
tools,
type,
updated_at,
version
FROM anthropic.agents.versions
WHERE agent_id = '{{ agent_id }}' -- required
AND "anthropic-workspace-id" = '{{ anthropic-workspace-id }}'
;