Remove an agent from an organization

DELETE

/organizations/{org_id}/agents/{agent_id}

const url = 'https://api.perstat.io/organizations/example/agents/example';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://api.perstat.io/organizations/example/agents/example \
  --header 'Authorization: Bearer <token>'

Removes the agent from the organization and immediately invalidates its per-agent token, so it stops reporting and disappears from listings. Monitors bound to this agent are archived in the same transaction: they stop checking, release their slot in the plan limit, and any open incidents on them are resolved, so no further alerts are sent for a host that no longer exists. Archived monitors keep their history, availability figures, and exclusion windows, and can be restored (they come back paused). Uninstalling the agent software from the host is a separate step. Requires project management rights. Accepts API keys with the agents:write scope, subject to current role and resource grants.

Authorizations

bearer

Parameters

Path Parameters

org_id

required

string

agent_id

required

string

Responses

204

Request succeeded. The response has no body.

401

Authentication is missing or invalid.

403

The authenticated caller does not have permission to perform this operation.

404

No accessible resource matches the supplied identifier.