{
  "cluster.allocation_explain": {
    "documentation": {
      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/cluster-allocation-explain.html",
      "description": "Explain the shard allocations"
    },
    "stability": "stable",
    "visibility": "public",
    "headers": {
      "accept": [
        "application/json"
      ],
      "content_type": [
        "application/json"
      ]
    },
    "url": {
      "paths": [
        {
          "path": "/_cluster/allocation/explain",
          "methods": [
            "GET",
            "POST"
          ]
        }
      ]
    },
    "params": {
      "master_timeout": {
        "type": "time",
        "default": "30s",
        "description": "Timeout for connection to master node"
      },
      "include_yes_decisions": {
        "type": "boolean",
        "default": false,
        "description": "Return 'YES' decisions in explanation (default: false)"
      },
      "include_disk_info": {
        "type": "boolean",
        "default": false,
        "description": "Return information about disk usage and shard sizes (default: false)"
      }
    },
    "body": {
      "description": "The index, shard, and primary flag to explain. Empty means 'explain a randomly-chosen unassigned shard'",
      "required": false
    }
  }
}
