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

# Update Agent

`PUT /api/agents/{path}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

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.dev/ascending-llc/apis/mcp-gateway-registry.md) - [All operations](https://skmtc.dev/ascending-llc/apis/mcp-gateway-registry/llms.txt) - [OpenAPI document](https://skmtc.dev/ascending-llc/apis/mcp-gateway-registry/revisions/31381943e2e7?raw)