Update

API Reference

Agents

Versions

Rollback to Agent Version

put/v2/gen-ai/agents/{uuid}/versions

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

Path ParametersExpand Collapse

uuid: string

Body ParametersExpand Collapse

uuid: optional string

Agent unique identifier

version_hash: optional string

Unique identifier

ReturnsExpand Collapse

audit_header: optional object { actor_id, actor_ip, actor_uuid, 4 more }

An alternative way to provide auth information. for internal use only.

actor_id: optional string

actor_ip: optional string

actor_uuid: optional string

context_urn: optional string

origin_application: optional string

user_id: optional string

user_uuid: optional string

version_hash: optional string

Unique identifier

HTTPPython

curl https://api.digitalocean.com/v2/gen-ai/agents/$UUID/versions \
    -X PUT \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $DIGITALOCEAN_ACCESS_TOKEN"

200 example

{
  "audit_header": {
    "actor_id": "12345",
    "actor_ip": "example string",
    "actor_uuid": "123e4567-e89b-12d3-a456-426614174000",
    "context_urn": "example string",
    "origin_application": "example string",
    "user_id": "12345",
    "user_uuid": "123e4567-e89b-12d3-a456-426614174000"
  },
  "version_hash": "example string"
}

Returns Examples

200 example

{
  "audit_header": {
    "actor_id": "12345",
    "actor_ip": "example string",
    "actor_uuid": "123e4567-e89b-12d3-a456-426614174000",
    "context_urn": "example string",
    "origin_application": "example string",
    "user_id": "12345",
    "user_uuid": "123e4567-e89b-12d3-a456-426614174000"
  },
  "version_hash": "example string"
}