---
type: api
title: Get agent action status
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-agents-action-status
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-agents-action-status
products:
  - Kibana
---

# Get agent action status

- Server: `https://{kibana_url}`

## Paths

- `GET` `/api/fleet/agents/action_status`
- `GET` `/s/{space_id}/api/fleet/agents/action_status`

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/kibana/v8/authentication#apikeyauth)
- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/kibana/v8/authentication#basicauth)

## Description

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

## Query String Parameters

- `perPage` (integer · default: 20)
  The number of items to return
- `page` (integer · default: 1)
- `errorSize` (integer · default: 5)

## Responses

#### `200`

OK

`application/json`

- `items` ([] object)
  - `actionId` (string)
  - `cancellationTime` (string)
  - `completionTime` (string)
  - `creationTime` (string)
    creation time of action
  - `expiration` (string)
  - `latestErrors` ([] object)
    latest errors that happened when the agents executed the action
    - `agentId` (string)
    - `error` (string)
    - `timestamp` (string)
  - `nbAgentsAck` (number)
    number of agents that acknowledged the action
  - `nbAgentsActionCreated` (number)
    number of agents included in action from kibana
  - `nbAgentsActioned` (number)
    number of agents actioned
  - `nbAgentsFailed` (number)
    number of agents that failed to execute the action
  - `newPolicyId` (string)
    new policy id (POLICY_REASSIGN action)
  - `policyId` (string)
    policy id (POLICY_CHANGE action)
  - `revision` (string)
    new policy revision (POLICY_CHANGE action)
  - `startTime` (string)
    start time of action (scheduled actions)
  - `status` (enum)
    Values: `COMPLETE`, `EXPIRED`, `CANCELLED`, `FAILED`, `IN_PROGRESS`, `ROLLOUT_PASSED`
  - `type` (enum)
    Values: `POLICY_REASSIGN`, `UPGRADE`, `UNENROLL`, `FORCE_UNENROLL`, `UPDATE_TAGS`, `CANCEL`, `REQUEST_DIAGNOSTICS`, `SETTINGS`, `POLICY_CHANGE`, `INPUT_ACTION`
  - `version` (string)
    agent version number (UPGRADE action)
#### `400`

Generic Error

`application/json`

- `error` (string)
- `message` (string)
- `statusCode` (number)
## Code Examples

#### Console

```console
GET /api/fleet/agents/action_status
```

#### curl

```curl
curl -X GET "https://{kibana_url}/api/fleet/agents/action_status"
```