---
title: "Deactivate agent (Enterprise)"
method: POST
path: "/api/v1/agents/{id}/deactivate"
tags: ["Agents"]
---

# Deactivate agent (Enterprise)

`POST /api/v1/agents/{id}/deactivate`

## Request

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

Deactivate an agent without deleting it.
**Enterprise only** - requires database-backed storage.

## Path parameters

- `id` string, uuid, required

## Response `200`

Agent deactivated

- AgentResponse
  - `agent` 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)