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

# Get Agent

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

## Path parameters

- `agent_id` string, uuid, required

## Headers

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

## 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)