Skip to main content

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

ParameterTypeRequiredDescription
agent_idstringYesThe unique identifier of the agent to delete
preserve_memorybooleanNoWhether to preserve memory data after agent deletion
export_databooleanNoExport agent data before deletion
This endpoint is not yet implemented. Agent management features are planned for a future release.