agent_versions

Creates, updates, deletes, gets or lists an agent_versions resource.

Overview

Name	agent_versions
Type	Resource
Id	digitalocean.genai.agent_versions

Fields

The following fields are returned by SELECT queries:

genai_list_agent_versions

A successful response.

Name	Datatype	Description
agent_versions	array	Agents
links	object	Links to other pages
meta	object	Meta information about the data set

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
genai_list_agent_versions	select	uuid	page, per_page	To list all agent versions, send a GET request to /v2/gen-ai/agents/{uuid}/versions.
genai_rollback_to_agent_version	exec	uuid		To update to a specific agent version, send a PUT request to /v2/gen-ai/agents/{uuid}/versions.

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
uuid	string	Agent unique identifier (example: "123e4567-e89b-12d3-a456-426614174000")
page	integer	Page number. (example: 1)
per_page	integer	Items per page. (example: 1)

SELECT examples

genai_list_agent_versions

To list all agent versions, send a GET request to /v2/gen-ai/agents/{uuid}/versions.

SELECT
agent_versions,
links,
meta
FROM digitalocean.genai.agent_versions
WHERE uuid = '{{ uuid }}' -- required
AND page = '{{ page }}'
AND per_page = '{{ per_page }}'
;

Lifecycle Methods

genai_rollback_to_agent_version

To update to a specific agent version, send a PUT request to /v2/gen-ai/agents/{uuid}/versions.

EXEC digitalocean.genai.agent_versions.genai_rollback_to_agent_version 
@uuid='{{ uuid }}' --required 
@@json=
'{
"uuid": "{{ uuid }}", 
"version_hash": "{{ version_hash }}"
}'
;