Create enrollment API key

POST /api/fleet/enrollment_api_keys

Headers

  • kbn-xsrf string Required

    Kibana's anti Cross-Site Request Forgery token. Can be any string value.

application/json; Elastic-Api-Version=2023-10-31

Body

  • name string

    The name of the enrollment API key. Must be unique.

  • policy_id string Required

    The ID of the agent policy the Elastic Agent will be enrolled in.

Responses

  • 200 application/json; Elastic-Api-Version=2023-10-31

    OK

    Hide response attributes Show response attributes object
    • action string

      Value is created.

    • item object

      Additional properties are allowed.

      Hide item attributes Show item attributes object
      • active boolean Required

        When false, the enrollment API key is revoked and cannot be used for enrolling Elastic Agents.

      • api_key string Required

        The enrollment API key (token) used for enrolling Elastic Agents.

      • api_key_id string Required

        The ID of the API key in the Security API.

      • created_at string Required
      • id string Required
      • name string

        The name of the enrollment API key.

      • policy_id string

        The ID of the agent policy the Elastic Agent will be enrolled in.
  • 400 application/json; Elastic-Api-Version=2023-10-31

    Generic Error

    Hide response attributes Show response attributes object
POST /api/fleet/enrollment_api_keys 
curl \
 -X POST https://localhost:5601/api/fleet/enrollment_api_keys \
 -H "Content-Type: application/json; Elastic-Api-Version=2023-10-31" \
 -H "kbn-xsrf: string"
Request examples 
# Headers
kbn-xsrf: string

# Payload
{
  "name": "string",
  "policy_id": "string"
}
Response examples (200) 
{
  "action": "created",
  "item": {
    "active": true,
    "api_key": "string",
    "api_key_id": "string",
    "created_at": "string",
    "id": "string",
    "name": "string",
    "policy_id": "string"
  }
}
Response examples (400) 
{
  "error": "string",
  "message": "string",
  "statusCode": 42.0
}