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

# Update Agent

`PATCH /api/v1/agents/{agent_id}`

## Path parameters

- `agent_id` string, uuid, required

## Headers

- `authorization` string, nullable — Bearer <token>

## Request body

- AgentUpdate
  - `channel` 'email' | 'push', nullable
  - `name` string, nullable
  - `trigger_description` string, nullable
  - `trigger_source` 'posthog_event' | 'subscription_event' | 'enrichment' | 'agent_chain' | 'renewal_date' | 'habit_rebuild' | 'habit_maintenance' | 'first_week', nullable
  - `event_name` string, nullable
  - `hogql_query` string, nullable
  - `property_filters` AppSchemasAgentPropertyFilter[], nullable
    - `key` string, required
    - `operator` string, required
    - `value` string, required
    - `type` string, nullable
  - `trigger_clauses` TriggerClause[], nullable
    - `event` string, required
    - `property_filters` AppSchemasAgentPropertyFilter[]
      - `key` string, required
      - `operator` string, required
      - `value` string, required
      - `type` string, nullable
    - `presence` 'did' | 'not_did'
    - `not_delay_days` integer, nullable
  - `trigger_match` 'any' | 'all', nullable
  - `condition_window_days` integer, nullable
  - `instructions` string, nullable
  - `sender_account` string, nullable
  - `sender_display_name` string, nullable
  - `resend_from_email` string, nullable
  - `reply_to` string, nullable
  - `auto_send` boolean, nullable
  - `delivery_mode` 'review' | 'auto' | 'slack' | 'discord' | 'resend' | 'autosend' | 'push' | 'info', nullable
  - `autonomy_level` 'off' | 'shadow' | 'live', nullable
  - `info_channel` 'slack' | 'discord', nullable
  - `digest_id` string, uuid, nullable
  - `enrichment_backfill_days` integer, nullable
  - `min_confidence` number, nullable
  - `enrichment_match_all` boolean, nullable
  - `poll_from` string, date-time, nullable
  - `trigger_delay_hours` integer, nullable
  - `trigger_delay_minutes` integer, nullable
  - `stale_after_hours` integer, nullable
  - `renewal_offset_days` integer, nullable
  - `parent_agent_id` string, uuid, nullable
  - `ignore_list` string[], nullable
  - `review_context_keys` string[], nullable
  - `cooldown_days` integer, nullable
  - `daily_cap` integer, nullable
  - `context_mode` 'trigger' | 'activity_window', nullable
  - `context_window_days` integer, nullable
  - `activity_gate` GateCondition[], nullable
    - `field` string, required
    - `operator` string, required
    - `value` string, required
  - `copy_mode` 'ai' | 'template', nullable
  - `copy_variants` CopyVariant[], nullable
    - `condition` GateCondition — A predicate on local customer state (see agent_query.GATE_FIELDS).
      - `field` string, required
      - `operator` string, required
      - `value` string, required
    - `subject` string
    - `body` string
    - `format` 'text' | 'html'
  - `enrichment_context_threshold` number, nullable
  - `enrichment_instructions` string, nullable
  - `feedback_questions` string, nullable
  - `enabled` boolean, nullable
  - `skip_redraft` boolean
  - `base_instructions_version` integer, nullable

## Response `200`

Successful Response

- EnvelopeAgentResponse
  - `data` AgentResponse, required
    - `id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `name` string, required
    - `trigger_description` string, nullable, required
    - `trigger_source` string
    - `event_name` string, nullable, required
    - `hogql_query` string, nullable, required
    - `property_filters` AppSchemasAgentPropertyFilter[]
      - `key` string, required
      - `operator` string, required
      - `value` string, required
      - `type` string, nullable
    - `trigger_clauses` TriggerClause[]
      - `event` string, required
      - `property_filters` AppSchemasAgentPropertyFilter[]
        - `key` string, required
        - `operator` string, required
        - `value` string, required
        - `type` string, nullable
      - `presence` 'did' | 'not_did'
      - `not_delay_days` integer, nullable
    - `trigger_match` string, required
    - `condition_window_days` integer, required
    - `last_polled_at` string, date-time, nullable, required
    - `instructions` string, required
    - `instructions_version` integer
    - `sender_account` string, nullable, required
    - `sender_display_name` string, nullable
    - `resend_from_email` string, nullable
    - `reply_to` string, nullable
    - `auto_send` boolean, required
    - `delivery_mode` string
    - `channel` string
    - `autonomy_level` string
    - `info_channel` string, nullable
    - `digest_id` string, uuid, nullable
    - `enrichment_backfill_days` integer
    - `min_confidence` number
    - `enrichment_match_all` boolean
    - `poll_from` string, date-time, nullable
    - `trigger_delay_hours` integer
    - `trigger_delay_minutes` integer
    - `stale_after_hours` integer
    - `renewal_offset_days` integer
    - `parent_agent_id` string, uuid, nullable
    - `ignore_list` string[]
    - `review_context_keys` string[]
    - `cooldown_days` integer, required
    - `daily_cap` integer, nullable, required
    - `context_mode` string, required
    - `context_window_days` integer, required
    - `activity_gate` GateCondition[]
      - `field` string, required
      - `operator` string, required
      - `value` string, required
    - `copy_mode` string
    - `copy_variants` CopyVariant[]
      - `condition` GateCondition — A predicate on local customer state (see agent_query.GATE_FIELDS).
        - `field` string, required
        - `operator` string, required
        - `value` string, required
      - `subject` string
      - `body` string
      - `format` 'text' | 'html'
    - `enrichment_context_threshold` number
    - `enrichment_instructions` string, nullable
    - `feedback_questions` string, nullable
    - `enabled` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `runs_today` integer
    - `total_runs` integer
    - `total_sends` integer
    - `matured_sends` integer
    - `open_rate_pct` integer, nullable
    - `push_sends` integer
    - `push_opens` integer
    - `return_adjudicated` integer
    - `return_returned` integer
    - `return_rate_pct` integer, nullable
    - `return_window_hours` integer, nullable
    - `feedback_signal_count` integer
    - `live_proposal_id` string, uuid, nullable
    - `live_proposal_count` integer
    - `last_open_at` string, date-time, nullable
    - `redraft_count` integer
    - `health` string, nullable
    - `health_reason` string, nullable
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
    - `total` integer, nullable
    - `truncated` boolean, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/minro/apis/minro-cs-platform.md) · [All operations](https://skmtc.dev/minro/apis/minro-cs-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/minro/minro-cs-platform/revisions/eb854265cf29/schema)