---
title: "Update an Agent"
method: PATCH
path: "/v1/agents/{agentId}"
tags: ["Agents"]
---

# Update an Agent

`PATCH /v1/agents/{agentId}`

This request can be used to update Hybrid Agents. The following fields can be updated:

- name - The name of the Agent.
- description - The description for the agent.
- enableAutoUpdates - Enabling Automatic Updates for the Agent. Note, this cannot be set for Snowflake Agents.
- restrictedAccess - Set to true and use in conjunction with the Allow list if you wish to restrict the use of the agent to specified Environments and Projects.
- trackName - The version track name for the Agent (CURRENT or STABLE). Note, Snowflake agents cannot be updated.

Please note, all the above fields are optional

## Path parameters

- `agentId` string, required

## Request body

- AgentUpdate
  - `description` string — The updated description to be applied to the Agent
  - `enableAutoUpdates` string — Set whether the Agent should automatically update. Note, Snowflake agents cannot have this value changed.
  - `name` string — The updated name to be applied to the Agent
  - `restrictedAccess` string — Set whether the Agent should be restricted to a specific set of projects. If set to true, the Agent will only be applicable to projects it is scoped to have access to. Note, this cannot be set for Streaming Agents.
  - `trackName` 'CURRENT' | 'STABLE' — The version track name to set for the Agent. Must be either CURRENT or STABLE. Note, Snowflake agents cannot be updated.

## Response `202`

Agent successfully updated

## Other responses

- `400` — Wrong request parameters used
- `403` — Forbidden
- `404` — Agent not found
- `500` — Unexpected error occurred

---

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