---
type: api
title: Elastic Agents
description: Elastic Agents APIs enable you to manage Elastic Agents, including retrieving agent information, managing agent lifecycle, handling file uploads, and initiating agent setup.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/group/endpoint-elastic-agents
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/group/endpoint-elastic-agents
products:
  - Kibana
---

# Elastic Agents

Elastic Agents APIs enable you to manage Elastic Agents, including retrieving agent information, managing agent lifecycle, handling file uploads, and initiating agent setup.

- [List agents](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-get-agents): `GET` `/api/fleet/agents`, `GET` `/s/{space_id}/api/fleet/agents`
- [List agents by action ids](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-get-agents-by-actions): `POST` `/api/fleet/agents`, `POST` `/s/{space_id}/api/fleet/agents`
- [Delete agent by ID](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-delete-agent): `DELETE` `/api/fleet/agents/{agentId}`, `DELETE` `/s/{space_id}/api/fleet/agents/{agentId}`
- [Get agent by ID](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-get-agent): `GET` `/api/fleet/agents/{agentId}`, `GET` `/s/{space_id}/api/fleet/agents/{agentId}`
- [Update agent by ID](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-update-agent): `PUT` `/api/fleet/agents/{agentId}`, `PUT` `/s/{space_id}/api/fleet/agents/{agentId}`
- [Reassign agent](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-reassign-agent): `POST` `/api/fleet/agents/{agentId}/reassign`, `POST` `/s/{space_id}/api/fleet/agents/{agentId}/reassign`
- [Reassign agent](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-reassign-agent-deprecated): `PUT` `/api/fleet/agents/{agentId}/reassign`, `PUT` `/s/{space_id}/api/fleet/agents/{agentId}/reassign`
- [Request agent diagnostics](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-request-diagnostics-agent): `POST` `/api/fleet/agents/{agentId}/request_diagnostics`, `POST` `/s/{space_id}/api/fleet/agents/{agentId}/request_diagnostics`
- [Unenroll agent](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-unenroll-agent): `POST` `/api/fleet/agents/{agentId}/unenroll`, `POST` `/s/{space_id}/api/fleet/agents/{agentId}/unenroll`
- [Upgrade agent](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-upgrade-agent): `POST` `/api/fleet/agents/{agentId}/upgrade`, `POST` `/s/{space_id}/api/fleet/agents/{agentId}/upgrade`
- [List agent uploads](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-list-agent-uploads): `GET` `/api/fleet/agents/{agentId}/uploads`, `GET` `/s/{space_id}/api/fleet/agents/{agentId}/uploads`
- [Bulk reassign agents](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-bulk-reassign-agents): `POST` `/api/fleet/agents/bulk_reassign`, `POST` `/s/{space_id}/api/fleet/agents/bulk_reassign`
- [Bulk request diagnostics from agents](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-bulk-request-diagnostics): `POST` `/api/fleet/agents/bulk_request_diagnostics`, `POST` `/s/{space_id}/api/fleet/agents/bulk_request_diagnostics`
- [Bulk unenroll agents](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-bulk-unenroll-agents): `POST` `/api/fleet/agents/bulk_unenroll`, `POST` `/s/{space_id}/api/fleet/agents/bulk_unenroll`
- [Bulk update agent tags](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-bulk-update-agent-tags): `POST` `/api/fleet/agents/bulk_update_agent_tags`, `POST` `/s/{space_id}/api/fleet/agents/bulk_update_agent_tags`
- [Bulk upgrade agents](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-bulk-upgrade-agents): `POST` `/api/fleet/agents/bulk_upgrade`, `POST` `/s/{space_id}/api/fleet/agents/bulk_upgrade`
- [Delete file uploaded by agent](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-delete-agent-upload-file): `DELETE` `/api/fleet/agents/files/{fileId}`, `DELETE` `/s/{space_id}/api/fleet/agents/files/{fileId}`
- [Get file uploaded by agent](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-get-agent-upload-file): `GET` `/api/fleet/agents/files/{fileId}/{fileName}`, `GET` `/s/{space_id}/api/fleet/agents/files/{fileId}/{fileName}`
- [Get agent setup info](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-get-agents-setup-status): `GET` `/api/fleet/agents/setup`, `GET` `/s/{space_id}/api/fleet/agents/setup`
- [Initiate agent setup](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-setup-agents): `POST` `/api/fleet/agents/setup`, `POST` `/s/{space_id}/api/fleet/agents/setup`
- [List agent tags](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-get-agent-tags): `GET` `/api/fleet/agents/tags`, `GET` `/s/{space_id}/api/fleet/agents/tags`