---
title: "List agents"
method: GET
path: "/agents"
tags: ["Agents Settings"]
---

# List agents

`GET /agents`

Get a list of the organization agents

## Query parameters

- `organizationId` string, required

## Response `200`

- AgentSettingsApiAgentResponse[]
  - `createdByUser` User
    - `email` string
    - `user_id` string
    - `created_at` string
    - `updated_at` string
    - `app_metadata` AppMetadata
      - `organizations` UserOrganization[]
        - `id` string, required
        - `role` string
        - `name` string
      - `isApiKey` boolean
      - `isAutogeneratedTerraformDeployer` boolean
      - `apiKeyType` 'oidc'
      - `createdBy` string
      - `organizationId` string
      - `isSystemUser` boolean
      - `readOnly` boolean
    - `picture` string
    - `name` string
    - `last_login` string
    - `given_name` string
    - `family_name` string
    - `blocked` boolean
  - `id` string
  - `agentKey` string, required
  - `name` string
  - `description` string
  - `logs` AgentSettingsApiAgentLogsConfig
    - `dynamo` object, required
      - `selfHosted` object, required
        - `accountId` string, required
        - `region` string, required
        - `externalId` string, required
  - `organizationId` string, required
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `createdBy` string
  - `isSaas` boolean
  - `isDefault` boolean
  - `status` 'ACTIVE' | 'INACTIVE' | 'DEGRADED', required
  - `health` object
    - `heartbeatAt` string, date-time, required
    - `pendingCount` number, required
    - `runningCount` number, required
    - `oldestQueuedTaskAt` string, date-time
    - `releaseVersion` string, required
  - `version` string

---

[API](https://skmtc.dev/envzero/apis/env0-api.md) · [All operations](https://skmtc.dev/envzero/apis/env0-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/envzero/env0-api/revisions/513441cbe9dc/schema)