MngDeleteAIAgent¶
DELETE ai/agent
Marks an agent as deleted. It disappears from the lists and can no longer answer, but the conversations it produced stay readable — otherwise an audit of past answers would lose its context.
To stop an agent temporarily, set enabled: false with
MngUpdateAIAgent instead.
Access Control¶
Allowed: admin. A shared agent can be deleted by a super administrator only.
Request¶
DELETE request
DELETE https://{broker_domain}/ai/agent
Authorization: <JWT_TOKEN>
Content-Type: application/json
{ "id": 3 }
{
"command": "MngDeleteAIAgent",
"extID": "1",
"data": { "id": 3 }
}
await platform.MngDeleteAIAgent({ id: 3 });
Parameters¶
| Parameter | Type | Description |
|---|---|---|
id |
int | Agent id |
Response Data¶
{ "id": 3, "deleted": true }
Errors¶
| Code | Error | Description |
|---|---|---|
403 |
AI_ACCESS_DENIED |
Not an administrator, or the agent belongs to another brand |
404 |
AI_AGENT_NOT_FOUND |
No such agent in this scope |