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

# Update Agent

`PUT /agents/{agent_id}`

Update an agent.

## Path parameters

- `agent_id` string, uuid, required

## Request body

- AgentUpdate — Update an existing agent.
  - `name` string, nullable
  - `description` string, nullable
  - `avatar_url` string, nullable
  - `slug` string, nullable
  - `character_id` string, uuid, nullable
  - `instructions` string, nullable
  - `deployment_config` DeploymentConfig — Agent deployment configuration.
    - `channels` string[]
    - `rate_limits` RateLimits — Rate limiting configuration for agent.
      - `messages_per_minute` integer
      - `messages_per_day` integer
    - `fallback` string
    - `fallback_message` string
    - `allowed_domains` string[]
    - `business_hours` BusinessHours — Business hours configuration.
      - `enabled` boolean
      - `start` string
      - `end` string
      - `timezone` string
      - `days` string[]
    - `welcome_message` string
    - `model_override` string, nullable
    - `linked_agent_ids` string[]
    - `schedules` ScheduleConfig[]
      - `name` string, required
      - `cron` string, required
      - `prompt` string, required
      - `timezone` string
      - `is_active` boolean
    - `tune_presets` TunePreset[]
      - `id` string, required
      - `name` string, required
      - `character_id` string, uuid, nullable
      - `voice_style` string
      - `model` string, nullable
  - `skill_template_ids` string[], nullable
  - `skill_pack_ids` string[], nullable
  - `is_active` boolean, nullable

## Response `200`

Successful Response

- AgentResponse — Agent response with all fields.
  - `name` string, required
  - `description` string, nullable
  - `avatar_url` string, nullable
  - `slug` string, nullable
  - `id` string, uuid, required
  - `space_id` string, uuid, required
  - `created_by` string, uuid, required
  - `character_id` string, uuid, nullable
  - `instructions` string, nullable
  - `deployment_config` object, required
  - `skill_template_ids` unknown[]
    - unknown
  - `skill_pack_ids` string[]
  - `api_key_prefix` string, nullable
  - `is_published` boolean, required
  - `is_active` boolean, required
  - `total_conversations` integer, required
  - `total_messages` integer, required
  - `avg_satisfaction` number, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `published_at` string, date-time, nullable
  - `character_name` string, nullable
  - `channel_count` integer
  - `mesh_sync_status` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/meganova/apis/fastapi.md) · [All operations](https://skmtc.net/meganova/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meganova/fastapi/revisions/2b2bab8b9017/schema)