---
title: "Update the description of an Agent."
method: PATCH
path: "/orgs/{orgId}/agents/{agentId}"
tags: ["Agents", "public"]
---

# Update the description of an Agent.

`PATCH /orgs/{orgId}/agents/{agentId}`

## Path parameters

- `orgId` string, required
- `agentId` string, required

## Request body

- AgentPatchBody — An object containing data to update the description field of an Agent.
  - `description` string, required — A description to show future users. It can be empty.

## Response `200`

Agent updated.

- Agent — An object containing the details of an Agent.
  - `id` string, required — The Agent id.
  - `description` string — A description to show future users. It can be empty.
  - `created_at` string, date-time, required — Time of the Agent being registered.
  - `created_by` string, required — User ID of user that added the Agent.

## Other responses

- `400` — The request was invalid. More detail can be found in the error body.
- `404` — Either the resource or a related resource could not be found. More detail can be found in the error body.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)