---
title: "Update Agent"
method: PUT
path: "/api/v1/agents/{id}"
tags: ["Agents"]
---

# Update Agent

`PUT /api/v1/agents/{id}`

Update an existing agent. If a new iconUrl is provided, the server will fetch the icon from the external URL, upload it to R2 storage, and delete the old icon. The response will contain the new R2 URL.

## Path parameters

- `id` string, required — The unique identifier

## Request body

- AgentUpdate
  - `scope` string
  - `slug` string
  - `displayName` string
  - `description` string
  - `iconUrl` string, uri
  - `author` string
  - `category` string
  - `tags` string[]
  - `agent` AgentPlatform
    - `platform` string, required
    - `url` string, uri, required

## Response `200`

Agent updated successfully

- AgentResponse
  - `agent` Agent, required
    - `scope` string, required
    - `slug` string, required
    - `displayName` string, required
    - `description` string, required
    - `iconUrl` string, uri
    - `author` string
    - `category` string
    - `tags` string[]
    - `agent` AgentPlatform, required
      - `platform` string, required
      - `url` string, uri, required
    - `createdAt` string, date-time
    - `updatedAt` string, date-time, required
    - `developerId` string
    - `id` string, required

## Other responses

- `400` — Invalid request data
- `401` — Unauthorized - authentication required
- `403` — Forbidden - not the owner or admin
- `404` — Agent not found
- `500` — Internal server error

## Changes

- **2026-01-21** `ba253fbf08a7` — 2 info
  - added the non-success response with the status `403`
  - added the optional property `agent/developerId` to the response with the `200` status
- **2026-01-18** `b0e6563d3fce` — 3 breaking, 3 warning, 1 info
  - the `code` response property const value `INTERNAL_SERVER_ERROR` was removed for the status `500`
  - the `code` response property const value `NOT_FOUND` was removed for the status `404`
  - the `code` response property const value `UNAUTHORIZED` was removed for the status `401`
  - added the new `INTERNAL_SERVER_ERROR` enum value to the `code` response property for the response status `500`
  - …3 more
- **2026-01-17** `4f3d96fe2656` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/corespeed-io/apis/mcp-store-api/changes/api/v1/agents/:id/put.md)

---

[API](https://skmtc.dev/corespeed-io/apis/mcp-store-api.md) · [All operations](https://skmtc.dev/corespeed-io/apis/mcp-store-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corespeed-io/mcp-store-api/revisions/25721894961a/schema)