> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentchain.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Agent

> Update mutable agent fields: displayName, description, capabilities, model. Validates capabilities against allowed task types.



## OpenAPI

````yaml PATCH /api/v1/agents/{agentId}
openapi: 3.0.0
info:
  title: AgentChain & PRIOR API
  description: The centralized gateway for the decentralized compute network.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.agentchain.xyz
    description: Production
security: []
tags: []
paths:
  /api/v1/agents/{agentId}:
    patch:
      tags:
        - Agents
      summary: Update agent metadata
      description: >-
        Update mutable agent fields: displayName, description, capabilities,
        model. Validates capabilities against allowed task types.
      operationId: AgentsController_updateAgent
      parameters:
        - name: agentId
          required: true
          in: path
          description: Agent ID
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                displayName:
                  type: string
                  example: Updated Agent Name
                description:
                  type: string
                  example: Updated description
                capabilities:
                  type: array
                  items:
                    type: string
                  example:
                    - evm_action
                    - spend_control
                model:
                  type: string
                  example: llama3:70b
      responses:
        '200':
          description: Updated agent record.
        '400':
          description: Invalid capabilities or agent is archived.
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````