---
title: "Update a agent"
method: PUT
path: "/agents/{agent_id}"
tags: ["Management"]
---

# Update a agent

`PUT /agents/{agent_id}`

Update agent settings

## Path parameters

- `agent_id` integer, required

## Request body

- Agent
  - `id` integer
  - `name` string
  - `address` string
  - `authorized` boolean
  - `ip_address` string
  - `state` integer
  - `disabled` boolean
  - `groups` object[]
  - `job` object
  - `last_seen` string, date-time
  - `host_info` object
  - `user_attrs` object

## Response `200`

Successfully

- Agent
  - `id` integer
  - `name` string
  - `address` string
  - `authorized` boolean
  - `ip_address` string
  - `state` integer
  - `disabled` boolean
  - `groups` object[]
  - `job` object
  - `last_seen` string, date-time
  - `host_info` object
  - `user_attrs` object

## Changes

> 50 revisions in range; 1 could not be searched.

- **2021-01-31** `ecd12e02213d` — 2 info
  - added optional request body
  - added the media type `application/json` for the response with the status `200`
- **2021-01-31** `6dffc3a4de00` — 2 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/kraken-ci/apis/server-api/changes/agents/:agent_id/put.md)

---

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