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

# Get agent setup info

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

## Paths

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

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

## Description

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

Get the current Fleet setup status, including whether Fleet is ready to enroll agents and which requirements or optional features are missing.<br/><br/>[Required authorization] Route required privileges: fleet-agents-read OR fleet-agent-policies-read OR fleet-settings-read OR fleet-setup.

## Responses

#### `200`

Fleet setup status

`application/json`

- `is_action_secrets_storage_enabled` (boolean)
- `is_fips_enabled` (boolean)
- `is_secrets_storage_enabled` (boolean)
- `is_space_awareness_enabled` (boolean)
- `is_ssl_secrets_storage_enabled` (boolean)
- `isReady` (boolean)
- `missing_optional_features` ([] enum  · max: 1)
  Values: `encrypted_saved_object_encryption_key_required`
- `missing_requirements` ([] enum  · max: 5)
  Values: `security_required`, `tls_required`, `api_keys`, `fleet_admin_user`, `fleet_server`
- `package_verification_key_id` (string)
#### `400`

Bad Request

`application/json`

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

#### Console

```console
GET /api/fleet/agents/setup
```

#### curl

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

## Response Examples

#### Agents setup not ready

Fleet is not ready — a Fleet Server and API keys are required

```json
{
  "is_action_secrets_storage_enabled": false,
  "is_secrets_storage_enabled": false,
  "is_space_awareness_enabled": false,
  "is_ssl_secrets_storage_enabled": false,
  "isReady": false,
  "missing_optional_features": [
    "encrypted_saved_object_encryption_key_required"
  ],
  "missing_requirements": [
    "fleet_server",
    "api_keys"
  ]
}
```

#### Agents setup ready

Fleet is ready to enroll agents — all requirements are met

```json
{
  "is_action_secrets_storage_enabled": true,
  "is_secrets_storage_enabled": true,
  "is_space_awareness_enabled": false,
  "is_ssl_secrets_storage_enabled": false,
  "isReady": true,
  "missing_optional_features": [],
  "missing_requirements": [],
  "package_verification_key_id": "D88DB4CC"
}
```

#### Generic error response

Example of a generic error response

```json
{
  "error": "Bad Request",
  "message": "An error message describing what went wrong",
  "statusCode": 400
}
```