---
title: "Get single Agent Group"
method: GET
path: "/api/v1/agent-groups/{agentGroupId}"
tags: ["AgentGroups"]
---

# Get single Agent Group

`GET /api/v1/agent-groups/{agentGroupId}`

## Path parameters

- `agentGroupId` integer, required

## Response `200`

OK

- DtoAgentGroupGetResponse
  - `data` DtoAgentGroupGet
    - `id` integer — Unique identifier for the Agent Group
    - `displayName` string — Display name for the Agent Group
    - `internalName` string — Internal name used by Frends for the Agent Group
    - `isCrossPlatform` boolean — Indicates whether the Agents in the group can be installed on Windows and Linux machines
    - `agents` string[] — The Agents that belong to the Agent Group
    - `environment` DtoEnvironmentBase
      - `id` integer — Unique identifier for the Environment
      - `displayName` string — Display name for the Environment
    - `agentDetails` DtoAgentGet[] — Details about the Agents that belong to the Agent Group
      - `url` string — The hostname or address for the agent. Can either be full URL https://example.org:1234 or hostname subdomain.example.org
      - `httpPorts` string[] — List of http ports the Agent listens to. If the Url is a full address (schema://hostname:port?) this can be ignored.
      - `httpsPorts` string[] — List of https ports the Agent listens to. If the Url is a full address (schema://hostname:port?) this can be ignored.
      - `id` integer — Agent Identifier
      - `name` string — Agent name
      - `isGateway` boolean — If the agent is a Gateway Agent. If true, these Agents are the ones that should primarily be accessible from the internet.
      - `isCloudAgent` boolean — If the agent is a Cloud Agent. If true, these Agents are managed by Frends.

## Other responses

- `404` — Agent Group not found

---

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