## List

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

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

### Returns

- **agent\_versions:** `array of object`

  Agents

  - **id:** `string`

    Unique identifier

  - **agent\_uuid:** `string`

    Uuid of the agent this version belongs to

  - **attached\_child\_agents:** `array of object`

    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:** `array of object`

    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:** `array of object`

    List of guardrail version

    - **is\_deleted:** `boolean`

      Whether the guardrail is deleted

    - **name:** `string`

      Guardrail Name

    - **priority:** `number`

      Guardrail Priority

    - **uuid:** `string`

      Guardrail UUID

  - **attached\_knowledgebases:** `array of object`

    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`

    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

  - **instruction:** `string`

    Instruction for the agent

  - **k:** `number`

    K value for the agent's configuration

  - **max\_tokens:** `number`

    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:** `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:** `array of string`

    Tags associated with the agent

  - **temperature:** `number`

    Temperature setting for the agent

  - **top\_p:** `number`

    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

- **meta:** `APIMeta`

  Meta information about the data set