---
title: "Toggle Agent"
method: PATCH
path: "/v1/agent/{agent_id}/toggle"
tags: ["agent"]
---

# Toggle Agent

`PATCH /v1/agent/{agent_id}/toggle`

## Request

- Base URL: `https://api.linktodm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.linktodm.com/v1/agent/{agent_id}/toggle`
- Auth: HTTP bearer

Set the agent's active state (the dashboard on/off switch).

## Path parameters

- `agent_id` integer, required

## Request body

- AgentTogglePayload: Explicit target state — idempotent, unlike a flip.
  - `is_active` boolean, required

## Response `200`

Successful Response

- ApiModelResponseSchema
  - `id` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/linktodm/apis/salesmorph.md) - [All operations](https://skmtc.dev/linktodm/apis/salesmorph/llms.txt) - [OpenAPI document](https://skmtc.dev/linktodm/apis/salesmorph/revisions/4af0ad5dbe92?raw)