Delete Agent - ARKOS Documentation

DELETE /v1/agents/

Coming soon! This endpoint will delete an ARKOS agent and optionally its associated memory data.

Planned Features

Safe agent termination
Memory export before deletion
Cascade deletion of related resources
Confirmation requirements for data loss prevention

Example Request

curl -X DELETE "http://localhost:8000/v1/agents/test-agent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "preserve_memory": false,
    "export_data": true
  }'

Example Response (Planned)

{
  "id": "test-agent",
  "status": "deleted",
  "memory_exported": true,
  "export_location": "/exports/test-agent_2024-01-15.json",
  "deleted_at": "2024-01-15T14:35:00Z"
}

Parameters

Parameter	Type	Required	Description
agent_id	string	Yes	The unique identifier of the agent to delete
preserve_memory	boolean	No	Whether to preserve memory data after agent deletion
export_data	boolean	No	Export agent data before deletion

This endpoint is not yet implemented. Agent management features are planned for a future release.