---
title: "List Agent Versions"
method: GET
path: "/v2/gen-ai/agents/{uuid}/versions"
tags: ["DigitalOcean-public.v2-new_GradientAI Platform"]
---

# List Agent Versions

`GET /v2/gen-ai/agents/{uuid}/versions`

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

## Path parameters

- `uuid` string, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

A successful response.

- ApiListAgentVersionsOutput — List of agent versions
  - `agent_versions` ApiAgentVersion[] — Agents
    - `agent_uuid` string — Uuid of the agent this version belongs to
    - `attached_child_agents` ApiAgentChildRelationshipVerion[] — List of child agent relationships
      - `agent_name` string — Name of the child agent
      - `child_agent_uuid` string — Child agent unique identifier
      - `if_case` string — If case
      - `is_deleted` boolean — Child agent is deleted
      - `route_name` string — Route name
    - `attached_functions` ApiAgentFunctionVersion[] — List of function versions
      - `description` string — Description of the function
      - `faas_name` string — FaaS name of the function
      - `faas_namespace` string — FaaS namespace of the function
      - `is_deleted` boolean — Whether the function is deleted
      - `name` string — Name of the function
    - `attached_guardrails` ApiAgentGuardrailVersion[] — List of guardrail version
      - `is_deleted` boolean — Whether the guardrail is deleted
      - `name` string — Guardrail Name
      - `priority` integer — Guardrail Priority
      - `uuid` string — Guardrail UUID
    - `attached_knowledgebases` ApiAgentKnowledgeBaseVersion[] — List of knowledge base agent versions
      - `is_deleted` boolean — Deletet at date / time
      - `name` string — Name of the knowledge base
      - `uuid` string — Unique id of the knowledge base
    - `can_rollback` boolean — Whether the version is able to be rolled back to
    - `created_at` string, date-time — Creation date
    - `created_by_email` string — User who created this version
    - `currently_applied` boolean — Whether this is the currently applied configuration
    - `description` string — Description of the agent
    - `id` string, uint64 — Unique identifier
    - `instruction` string — Instruction for the agent
    - `k` integer — K value for the agent's configuration
    - `max_tokens` integer — Max tokens setting for the agent
    - `model_name` string — Name of model associated to the agent version
    - `name` string — Name of the agent
    - `provide_citations` boolean — Whether the agent should provide in-response citations
    - `retrieval_method` 'RETRIEVAL_METHOD_UNKNOWN' | 'RETRIEVAL_METHOD_REWRITE' | 'RETRIEVAL_METHOD_STEP_BACK' | 'RETRIEVAL_METHOD_SUB_QUERIES' | 'RETRIEVAL_METHOD_NONE' — - RETRIEVAL_METHOD_UNKNOWN: The retrieval method is unknown - RETRIEVAL_METHOD_REWRITE: The retrieval method is rewrite - RETRIEVAL_METHOD_STEP_BACK: The retrieval method is step back - RETRIEVAL_METHOD_SUB_QUERIES: The retrieval method is sub queries - RETRIEVAL_METHOD_NONE: The retrieval method is none
    - `tags` string[] — Tags associated with the agent
    - `temperature` number, float — Temperature setting for the agent
    - `top_p` number, float — Top_p setting for the agent
    - `trigger_action` string — Action triggering the configuration update
    - `version_hash` string — Version hash
  - `links` ApiLinks — Links to other pages
    - `pages` ApiPages — Information about how to reach other pages
      - `first` string — First page
      - `last` string — Last page
      - `next` string — Next page
      - `previous` string — Previous page
  - `meta` ApiMeta — Meta information about the data set
    - `page` integer — The current page
    - `pages` integer — Total number of pages
    - `total` integer — Total amount of items over all pages

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

---

[API](https://skmtc.net/digitalocean/apis/digitalocean-api.md) · [All operations](https://skmtc.net/digitalocean/apis/digitalocean-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalocean/digitalocean-api/revisions/cb3bf9b21459/schema)