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

# Update agent

> Update the YAML source of truth for an agent.

Only in Mage Pro.

Try our fully managed solution to access this advanced feature.

[Get started for free](https://cloud.mage.ai/sign-up?source=agents-api)

```http theme={"system"}
PUT /api/agents/{agent_uuid}
```

```json theme={"system"}
{
  "agent": {
    "name": "Customer support agent",
    "description": "Routes urgent support questions.",
    "instructions": "Classify the request and recommend escalation.",
    "actions": [
      {
        "pipeline_uuid": "support_workflows",
        "block_uuid": "triage_ticket"
      }
    ]
  }
}
```

Updates write directly to the agent YAML file. Agent versions and rollback records are not created.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.