Delete Agent Endpoint

curl --request DELETE \
  --url https://api.nugen.in/api/v3/agents/{agent_id} \
  --header 'Authorization: Bearer <token>'

{
  "agent_id": "agent-123",
  "message": "Agent deleted successfully"
}

Agents

Delete Agent Endpoint

Permanently delete an agent.

This endpoint performs a hard delete of an agent. The operation is irreversible and removes agent configuration, history, and usage data.

Path Parameters:

agent_id: Unique identifier of the agent to delete

Returns:

agent_id: ID of the deleted agent
message: Success confirmation message

Raises:

404: Agent not found or doesn’t belong to the user

Example Request:

DELETE /api/v3/agents/agent-abc123
Headers: {"Authorization": "Bearer <api_key>"}

Example Response:

{
  "agent_id": "agent-abc123",
  "message": "Successfully deleted agent agent-abc123"
}

Warning:

This is a permanent deletion. All agent data including configuration, history, and usage statistics will be removed and cannot be recovered.

DELETE

api

agents

{agent_id}

Delete Agent Endpoint

curl --request DELETE \
  --url https://api.nugen.in/api/v3/agents/{agent_id} \
  --header 'Authorization: Bearer <token>'

{
  "agent_id": "agent-123",
  "message": "Agent deleted successfully"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id

string

required

Response

Returns a confirmation message indicating successful deletion of the agent along with the agent ID

agent_id

string

required

Agent identifier

Example:

"agent-123"

message

string

required

Response Message

Example:

"Agent deleted successfully"

Get Agent Update Agent Endpoint

Models

Agents

Documents

Benchmark

Evaluations

Alignment Project

Inference

Delete Agent Endpoint

Authorizations

Path Parameters

Response