Delete Agent

Beta

DELETE/v1/ai/agents/{id}

This endpoint is idempotent. Learn more

Deletes a custom agent.

The agent is withdrawn from the API: it stops appearing in listings, no longer resolves by ID, and can no longer be run or modified. Runs it already produced are kept. Augno's system agents cannot be deleted — disable one for your account with the Update Agent Status endpoint instead.

Permissions requiredValues:agents:delete

The role behind your API key or agent must grant every one of these permissions.

idstring

Agent definition ID.

Responses

200

Successful response for Delete Agent

Delete Agent

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const agent = await client.ai.agents.delete('agdf_ah7tkyfxk8jl');

console.log(agent);

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const agent = await client.ai.agents.delete('agdf_ah7tkyfxk8jl');

console.log(agent);

200 example

{}

{}

Delete Agent

Authorization

Path Parameters

Responses