---
title: "Get agent by ID (Enterprise)"
method: GET
path: "/api/v1/agents/{id}"
tags: ["Agents"]
---

# Get agent by ID (Enterprise)

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

## Request

- Base URL: `https://orchestrator.getaxonflow.com`
- URL: `https://orchestrator.getaxonflow.com/api/v1/agents/{id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/docs/api/v1/agents/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns detailed information about a specific agent.
The ID format is `domain/name` (e.g., `travel/flight-booking`).

**Enterprise only** - the `/api/v1/agents` family is not registered in Community.

## Path parameters

- `id` string, required

## Response `200`

Agent details

- AgentResource
  - `id` string: Qualified ID (domain/name)
  - `name` string: Agent name
  - `domain` string: Agent domain
  - `description` string: Agent description
  - `version` integer: Version number
  - `is_active` boolean: Whether agent is active
  - `config` AgentConfigSpec: Agent configuration specification
    - `execution` object
      - `default_mode` 'auto' | 'parallel' | 'sequential'
      - `max_parallel_tasks` integer
      - `timeout_seconds` integer
    - `agents` AgentDefinition[]
      - `name` string, required
      - `type` 'llm-call' | 'connector-call', required
      - `llm` object: LLM config (required for llm-call type)
        - `provider` string
        - `model` string
      - `connector` object: Connector config (required for connector-call type)
        - `name` string
        - `operation` string
    - `routing` RoutingRule[]
      - `pattern` string, required: Regex pattern to match
      - `agent` string, required: Target agent name
      - `priority` integer: Higher priority rules match first
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `404`: Agent not found

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/revisions/f408ef3ec9dd?raw)