Delete a custom AI agent

DELETE 
/ai/agents/:id

Starts deletion of a CUSTOM agent. Caller must be owner. SYSTEM agents cannot be deleted (AI-1002). Agents whose AgentStatus ends with ING (CREATING, UPDATING, DELETING) cannot be deleted (AI-1002). Agents attached to AI projects must be detached first (AI-1003). On success the API sets AgentStatus to DELETING, returns 200, and continues IAM/runtime/S3 cleanup asynchronously. Caller must send a valid role_id. Requires AICore enabled.

Request

Responses

200

Deletion started; cleanup continues asynchronously.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Validation or authorization failure. Body is {"Message": " - "}. AUTH-1001 missing role_id. AUTH-* insufficient API or owner permission. AI-1004 when AICore is not enabled.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. AI-1002 agent not found, SYSTEM agent, or in-progress status. AI-1003 agent still attached to projects. GE-1044 unexpected errors.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers