<!-- Generated from the canonical Teloring documentation source. Do not edit this file. -->

Canonical page: https://docs.teloring.com/api/delete-agent
Last modified: 2026-08-20T20:52:05.000Z

# Deactivate an agent

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";
import Translate from "@docusaurus/Translate";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Deactivate an agent"}
>
</Heading>

<MethodEndpoint
  method={"delete"}
  path={"/agents/{agent_id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Deactivate an agent.

They can no longer sign in and stop receiving assignments, but their name and
history stay intact — a message has to keep showing who sent it. The seat is
released at the next billing cycle.

Any SSO permission naming this agent is removed at the same time, which
invalidates every SSO link already issued for them.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails
  {...require("./delete-agent.ParamsDetails.json")}
>
  
</ParamsDetails>

<RequestSchema
  {...require("./delete-agent.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./delete-agent.StatusCodes.json")}
>
  
</StatusCodes>
