{
  "security.put_role_mapping": {
    "documentation": {
      "url": "https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-put-role-mapping",
      "description": "Create or update role mappings"
    },
    "stability": "stable",
    "visibility": "public",
    "headers": {
      "accept": [
        "application/json"
      ],
      "content_type": [
        "application/json"
      ]
    },
    "url": {
      "paths": [
        {
          "path": "/_security/role_mapping/{name}",
          "methods": [
            "PUT",
            "POST"
          ],
          "parts": {
            "name": {
              "type": "string",
              "description": "Role-mapping name"
            }
          }
        }
      ]
    },
    "params": {
      "refresh": {
        "type": "enum",
        "options": [
          "true",
          "false",
          "wait_for"
        ],
        "description": "If `true` (the default) then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` then do nothing with refreshes."
      }
    },
    "body": {
      "description": "The role mapping to add",
      "required": true
    }
  }
}
