---
title: "Agent"
method: PUT
path: "/agents/{AgentID}"
tags: ["Agents"]
---

# Agent

`PUT /agents/{AgentID}`

Edits a deployed liongard agent, cannot update On-Demand agents.

## Path parameters

- `AgentID` integer, required

## Request body

- AgentRequest
  - `Name` string, required
  - `Description` string
  - `Environment` object
    - `ID` integer

## Response `200`

- Agents[]
  - `ID` integer
  - `Environment` EnvironmentsTrimmed
    - `ID` integer
    - `ServiceProviderID` integer
    - `Name` string
    - `ShortName` string, nullable
    - `Description` string
    - `Status` integer
    - `Visible` boolean
    - `ExpiresOn` string
    - `KeyRotation` integer
    - `LastKeyRotation` string
    - `Website` string, nullable
    - `Static` boolean
    - `CreatedOn` string
    - `UpdatedOn` string, nullable
    - `Tier` string
  - `Data` object
    - `PSVersion` string
    - `JobsRunning` integer
    - `AgentVersion` string
    - `MaxJobsAllowed` integer
    - `AutoUpdatingStatus` string, nullable
  - `UID` string
  - `Bucket` string
  - `Name` string
  - `Description` string
  - `Status` integer
  - `Hostname` string
  - `IP` string
  - `JobQueue` string
  - `Platform` string
  - `Suspended` boolean
  - `Managed` boolean
  - `LastHeartbeat` string
  - `CreatedOn` string
  - `UpdatedOn` string, nullable
  - `UpdatesCheckedOn` string, nullable
  - `Type` string
  - `CreatedBy` object
    - `ID` integer
    - `FirstName` string
    - `LastName` string
    - `Username` string
  - `SAAS` boolean

---

[API](https://skmtc.net/liongard/apis/liongard-v2-endpoints.md) · [All operations](https://skmtc.net/liongard/apis/liongard-v2-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liongard/liongard-v2-endpoints/versions/4ba1aeff82d7/schema)