## List

`agents.versions.list(struuid, VersionListParams**kwargs)  -> VersionListResponse`

**get** `/v2/gen-ai/agents/{uuid}/versions`

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

### Parameters

- **uuid:** `str`

- **page:** `int`

  Page number.

- **per\_page:** `int`

  Items per page.

### Returns

- `class VersionListResponse`

  List of agent versions

  - **agent\_versions:** `Optional[List[AgentVersion]]`

    Agents

    - **id:** `Optional[str]`

      Unique identifier

    - **agent\_uuid:** `Optional[str]`

      Uuid of the agent this version belongs to

    - **attached\_child\_agents:** `Optional[List[AgentVersionAttachedChildAgent]]`

      List of child agent relationships

      - **agent\_name:** `Optional[str]`

        Name of the child agent

      - **child\_agent\_uuid:** `Optional[str]`

        Child agent unique identifier

      - **if\_case:** `Optional[str]`

        If case

      - **is\_deleted:** `Optional[bool]`

        Child agent is deleted

      - **route\_name:** `Optional[str]`

        Route name

    - **attached\_functions:** `Optional[List[AgentVersionAttachedFunction]]`

      List of function versions

      - **description:** `Optional[str]`

        Description of the function

      - **faas\_name:** `Optional[str]`

        FaaS name of the function

      - **faas\_namespace:** `Optional[str]`

        FaaS namespace of the function

      - **is\_deleted:** `Optional[bool]`

        Whether the function is deleted

      - **name:** `Optional[str]`

        Name of the function

    - **attached\_guardrails:** `Optional[List[AgentVersionAttachedGuardrail]]`

      List of guardrail version

      - **is\_deleted:** `Optional[bool]`

        Whether the guardrail is deleted

      - **name:** `Optional[str]`

        Guardrail Name

      - **priority:** `Optional[int]`

        Guardrail Priority

      - **uuid:** `Optional[str]`

        Guardrail UUID

    - **attached\_knowledgebases:** `Optional[List[AgentVersionAttachedKnowledgebase]]`

      List of knowledge base agent versions

      - **is\_deleted:** `Optional[bool]`

        Deletet at date / time

      - **name:** `Optional[str]`

        Name of the knowledge base

      - **uuid:** `Optional[str]`

        Unique id of the knowledge base

    - **can\_rollback:** `Optional[bool]`

      Whether the version is able to be rolled back to

    - **created\_at:** `Optional[datetime]`

      Creation date

    - **created\_by\_email:** `Optional[str]`

      User who created this version

    - **currently\_applied:** `Optional[bool]`

      Whether this is the currently applied configuration

    - **description:** `Optional[str]`

      Description of the agent

    - **instruction:** `Optional[str]`

      Instruction for the agent

    - **k:** `Optional[int]`

      K value for the agent's configuration

    - **max\_tokens:** `Optional[int]`

      Max tokens setting for the agent

    - **model\_name:** `Optional[str]`

      Name of model associated to the agent version

    - **name:** `Optional[str]`

      Name of the agent

    - **provide\_citations:** `Optional[bool]`

      Whether the agent should provide in-response citations

    - **retrieval\_method:** `Optional[APIRetrievalMethod]`

      - 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:** `Optional[List[str]]`

      Tags associated with the agent

    - **temperature:** `Optional[float]`

      Temperature setting for the agent

    - **top\_p:** `Optional[float]`

      Top_p setting for the agent

    - **trigger\_action:** `Optional[str]`

      Action triggering the configuration update

    - **version\_hash:** `Optional[str]`

      Version hash

  - **links:** `Optional[APILinks]`

    Links to other pages

  - **meta:** `Optional[APIMeta]`

    Meta information about the data set

### Example

```python
from do_gradientai import GradientAI

client = GradientAI()
versions = client.agents.versions.list(
    uuid="\"123e4567-e89b-12d3-a456-426614174000\"",
)
print(versions.agent_versions)
```