---
updatedAt: 2026-07-31T12:37:05.000Z
---

# Delete an Agent

Permanently deletes an agent from IBM Verify.

**Required Entitlements** (at least one): tenantAdmin, writeAgents, agentOwner

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0.0",
    "description": "AI Agents",
    "title": "AI Agents"
  },
  "servers": [
    {
      "url": "https://{tenanturl}",
      "variables": {
        "tenanturl": {
          "default": "{tenant_url}",
          "description": "URL of your IBM Security Verify tenant"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Agent management",
      "description": "SCIM 2.0 compliant agent operations"
    }
  ],
  "paths": {
    "/v1.0/Agents/{id}": {
      "delete": {
        "tags": [
          "Agent management"
        ],
        "summary": "Delete an Agent",
        "description": "Permanently deletes an agent from IBM Verify.\n\n**Required Entitlements** (at least one): tenantAdmin, writeAgents, agentOwner",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Unique identifier of the agent (UUID)",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Agent deleted successfully - No Content",
            "content": {}
          },
          "401": {
            "description": "Unauthorized - Authentication required",
            "content": {}
          },
          "403": {
            "description": "Forbidden - Insufficient permissions (CSINH2501E)",
            "content": {}
          },
          "404": {
            "description": "Not Found - Agent not found (CSINH2001E)",
            "content": {}
          },
          "500": {
            "description": "Internal Server Error (CSINH1000E)",
            "content": {}
          }
        },
        "x-category": "AI Agents",
        "x-publicAPI": "true"
      }
    }
  },
  "x-original-swagger-version": "2.0",
  "x-explorer-enabled": false
}
```