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

# Update Agent

`PUT /api/agents/{path}`

Update an existing agent card.

Requires modify_service permission for the agent.
User must be agent owner or admin.

Args:
    path: Agent path
    request: Updated agent data
    user_context: Authenticated user context

Returns:
    Updated agent card

Raises:
    HTTPException: 404 if not found, 403 if unauthorized

## Path parameters

- `path` string, required

## Request body

- AgentRegistrationRequest — API request model for agent registration. This model is used for the agent registration API endpoint and converts form-style inputs (e.g., comma-separated tags) into the proper types. Accepts both snake_case (Python) and camelCase (A2A spec JSON) field names.
  - `name` string, required — Agent name
  - `description` string — Agent description
  - `url` string, required — Agent endpoint URL
  - `path` string, nullable — Registry path (optional - auto-generated if not provided)
  - `protocolVersion` string — A2A protocol version
  - `version` string, nullable — Agent version
  - `provider` object, nullable — Agent provider information {organization, url}
  - `securitySchemes` object, nullable — Security schemes configuration
  - `skills` object[], nullable — Agent skills
  - `streaming` boolean — Supports streaming responses
  - `tags` union — Comma-separated tags or list of tags
    - string
    - string[]
  - `license` string — License information
  - `visibility` string — Visibility: public, private, or group-restricted

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ascending-llc/apis/mcp-gateway-registry.md) · [All operations](https://skmtc.net/ascending-llc/apis/mcp-gateway-registry/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ascending-llc/mcp-gateway-registry/versions/31381943e2e7/schema)