---
title: "List agents in an environment"
method: GET
path: "/organization/{organization_id}/project/{project}/managed-agents/agent"
tags: ["Service:_Managed_Agents"]
---

# List agents in an environment

`GET /organization/{organization_id}/project/{project}/managed-agents/agent`

## Request

- Base URL: `https://api.aiven.io/v1`
- URL: `https://api.aiven.io/v1/organization/{organization_id}/project/{project}/managed-agents/agent`
- Auth: HTTP bearer and OAuth 2
  - Authorization code: `https://console.aiven.io/oauth/authorize`
  - Token URL: `https://api.aiven.io/v1/oauth2/token` scopes: `services:read`

> This endpoint **may be changed or removed at any time**. Don't use it in production environments.

Agents whose Aiven permissions exceed the caller's own project access are hidden.

## Path parameters

- `organization_id` string, required
- `project` string, required

## Response `200`

Response

- ManagedAgentsAgentListResponse: ManagedAgentsAgentListResponse
  - `agents` object[]: Agents
    - `created_at` string: Creation time
    - `id` string, required: Agent ID
    - `model` string: Model identifier
    - `name` string, required: Agent name
    - `tools` object[]: Attached tools
      - `description` string: Tool description
      - `id` string, required: Tool ID
      - `name` string, required: Tool name

## Other responses

- `400`: Invalid request parameters
- `403`: Operation not allowed

## Changes

- **2026-10-12** `8bc631e52c97`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/aiven/apis/aiven-api-documentation/changes/organization/:organization_id/project/:project/managed-agents/agent/get.md)

---

[API](https://skmtc.dev/aiven/apis/aiven-api-documentation.md) - [All operations](https://skmtc.dev/aiven/apis/aiven-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aiven/apis/aiven-api-documentation/revisions/562453405db0?raw)