---
title: "Get agent by id"
method: GET
path: "/v1/agents/{id}"
tags: ["agents"]
---

# Get agent by id

`GET /v1/agents/{id}`

Returns a single V2 chat agent by id.

## Path parameters

- `id` string, required — Agent id.

## Query parameters

- `workspace_id` string — Optional workspace override. If omitted, Conduit resolves the agent's workspace automatically.

## Response `200`

Agent

- object — Single V2 chat agent response.
  - `data` object, required
    - `id` string, required
    - `workspace_id` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `color` string, nullable, required
    - `icon_id` number, nullable, required
    - `version` 'v2', required
    - `instructions` string, nullable, required
    - `model` string, required — The LLM this agent runs on: a kb_api `model_string` (e.g. `openai:gpt-4o`), or `default` when no override is set.
    - `guardrails` object[], required
      - `id` string
      - `title` string, required
      - `knowledge` string, required
    - `operation_mode` 'autopilot' | 'copilot' | 'inactive', required
    - `autopilot_schedule` object, nullable, required — Autopilot schedule. Autopilot only sends inside the enabled day windows; outside them the agent falls back to copilot. Omit or set null for always-on autopilot.
      - `timezone` string, required — IANA timezone the schedule is evaluated in, e.g. "America/New_York".
      - `days` object[], required — Per-day autopilot windows.
        - `day` 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday', required — Day of the week this window applies to.
        - `enabled` boolean, required — Whether autopilot is active on this day.
        - `ranges` object[], required — Time windows during which autopilot is active on this day.
          - `start` string, required — Window start as a 12-hour clock time, e.g. "09:00 AM".
          - `end` string, required — Window end as a 12-hour clock time, e.g. "05:00 PM".
    - `custom_response_delay_ms` number, required
    - `auto_mark_as_done` boolean, required
    - `response_language` 'English' | 'Original' | 'Spanish' | 'French' | 'German' | 'Italian' | 'Portuguese', nullable, required
    - `responseflow` boolean, required
    - `output_schema` object[], required
      - `name` string, required
      - `description` string
      - `type` string, required
      - `is_required` boolean
    - `skill_ids` string[], required
    - `connection_ids` string[], required — Ids of the integration connections linked to this agent. Use list_agent_connections (GET /v1/agents/{id}/connections) for the full connection details and their tools.
    - `enabled` boolean, required
    - `triggers` union[], required
      - union
        - object
          - `id` string, required
          - `workspace_id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `type` 'message', required
          - `config` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - unknown
          - `enabled` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
        - object
          - `id` string, required
          - `workspace_id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `type` 'webhook', required
          - `config` unknown
          - `enabled` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
        - object
          - `id` string, required
          - `workspace_id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `type` 'cron', required
          - `config` unknown
          - `enabled` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
        - object
          - `id` string, required
          - `workspace_id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `type` 'event', required
          - `config` unknown
          - `enabled` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
        - object
          - `id` string, required
          - `workspace_id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `type` 'mention', required
          - `config` union, required
            - object
              - …
            - object
              - …
            - object
              - …
          - `enabled` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
        - object
          - `id` string, required
          - `workspace_id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `type` 'manual', required
          - `config` unknown
          - `enabled` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
    - `created_at` string, required
    - `updated_at` string, required

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/conduit/apis/conduit-api.md) · [All operations](https://skmtc.dev/conduit/apis/conduit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conduit/conduit-api/revisions/3ad7e17f96ad/schema)