Bulk enable/disable namespace-level customization for packages

Base URL: https://{kibana_url}

POST /api/fleet/epm/packages/_bulk_namespace_customization

Auth

Enable or disable namespace-level index template customization for a list of packages in one call. Use this for IaC-style declarative flows.

Required privileges

Privileges integrations-all and fleet-agent-policies-all

Header parameters

kbn-xsrf string required: A required header to protect against CSRF attacks

Request body

disable string[] · max items: 100: Namespaces to disable namespace-level customization for on each package.
enable string[] · max items: 100: Namespaces to enable namespace-level customization for on each package.
packages string[] · min items: 1 · max items: 1000 required: Package names to apply the customization changes to.

Responses

OK: A successful request.

application/json

items object[] · max items: 1000 required

A bad request.

application/json

View as Markdown

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

POST kbn:/api/fleet/epm/packages/_bulk_namespace_customization
{
  "disable": [
    "dev"
  ],
  "enable": [
    "production",
    "staging"
  ],
  "packages": [
    "system",
    "nginx"
  ]
}

Generated from the API spec

curl Shell

curl -X POST "${KIBANA_URL}/api/fleet/epm/packages/_bulk_namespace_customization" \
  -H "kbn-xsrf: true" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "disable": [
      "dev"
    ],
    "enable": [
      "production",
      "staging"
    ],
    "packages": [
      "system",
      "nginx"
    ]
  }'

Generated from the API spec

Response

{
  "items": [
    {
      "name": "system",
      "namespace_customization_enabled_for": [
        "production",
        "staging"
      ],
      "success": true
    },
    {
      "error": "Package nginx is not installed",
      "name": "nginx",
      "success": false
    }
  ]
}

{
  "error": "Bad Request",
  "message": "Namespaces must not appear in both enable and disable: production",
  "statusCode": 400
}

Required privileges

Header parameters

Request body { }

Responses

Request body