---
title: "# Agent Detail"
method: GET
path: "/v1/agents/{Id}"
tags: ["Agents"]
---

# # Agent Detail

`GET /v1/agents/{Id}`

Agent Detail; Agent Name, Agent Status, Agent Type, Agent Created Time, Agent Platform,
Agent Mitigation Devices, Agent Attack Modules

## Path parameters

- `Id` integer, required

## Response `200`

AgentDetailReturnSwagger

- object
  - `Agent` AgentDetailReturn
    - `affected_platforms` AffectedPlatform[]
      - `architecture` string — Affected Platform Architecture
      - `name` string — Affected Platform Name
    - `attack_modules` Module[]
      - `enabled` boolean — Is Attack Module Enable
      - `id` integer — Attack Module Id
      - `name` string — Attack Module like File Download
    - `created_at` integer — Agent Created at
    - `devices` Device[]
      - `id` integer — Identifier
      - `name` string — Security Device Name like FortiWeb
      - `product_platform` string — Product Platform like FGWVM
      - `product_version` string — Product version
    - `id` integer — Agent Id
    - `ip` string — Agent Ip 1.1.1.1
    - `is_update_needed` boolean — Is agent should update to run simulation
    - `name` string — Agent Name
    - `nat_ip` string — Agent Nat Ip 0.0.0.0
    - `platform_architecture` string — Platform Architecture like 64-bit
    - `platform_name` string — Platform Name like Windows 10
    - `status` string — Agent status gives information about your agent alive ( alive | dead | expired )
    - `type` string — Agent type (QuickEmail | Browser | Installable Agent | Windows | Linux | MacOS)
    - `version` string — Agent Version like 3.4.0.0

## Other responses

- `422` — validationErrorSwagger is represents the erroneous cases
- `default` — genericErrorSwagger is represents the erroneous cases

---

[API](https://skmtc.net/picussecurity/apis/picus-rest-api.md) · [All operations](https://skmtc.net/picussecurity/apis/picus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/picussecurity/picus-rest-api/versions/cb0d02ee28f8/schema)