7en.ai

Navigation

agent

Agent ObjectCreate AgentUpdate AgentDelete AgentList All Agents

api reference

IntroductionError handling

agent

Agent ObjectCreate AgentUpdate AgentDelete AgentList All Agents

api reference

IntroductionError handling

Delete Agent

Delete an existing AI agent by its ID.

Overview

The Delete Agent endpoint allows you to remove an AI agent from your account. This action is irreversible, so ensure the agent is no longer needed before deleting.

Parameters

Request Header

Authorization

api key

Api key generated from 7en.i platform. Example: Api-Key 43NKLN3LKN4nlkn

Error Responses

Base url: api.7en.ai

401 unauthorized
json
{
"error": {
"code": "authentication_required",
"message": "Authentication failed.",
"status": 401,
"fields": []
}
}
404 not found
json
{
"error": {
"code": "NOT_FOUND",
"message": "Agent with ID 11 not found.",
"status": 404,
"fields": []
}
}

Best Practices

  • Confirmation: Always verify the agent ID before deletion to avoid accidental removal.
  • Backup: Consider backing up critical agent configurations before deletion.
  • Rate Limits: Be aware of rate limits when performing multiple delete operations.

Rate Limits

  • 100 requests per minute for free tier
  • 1000 requests per minute for pro tier
  • 10000 requests per minute for enterprise tier

Ready to transform your business?

Start building intelligent AI agents to engage with customers.

← Update Agent
List All Agents →
DELETE/v1/agents/{id}

Request

curl -X DELETE 'https://{% api.7en.ai %}v1/agents/11' -H 'Authorization: {% Api-Key YOUR_API_KEY %}' -H 'Content-Type: application/json'

Response

{
"status": "success",
"message": "Agent with ID 11 deleted successfully."
}