Disable users Generally available

PUT /_security/user/{username}/_disable
Api key auth Basic auth Bearer auth

Disable users in the native realm. By default, when you create users, they are enabled. You can use this API to revoke a user's access to Elasticsearch.

Required authorization

  • Cluster privileges: manage_security

Path parameters

  • username string Required

    An identifier for the user.

Query parameters

  • refresh string

    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.

    Values are true, false, or wait_for.

Responses

  • 200 application/json
PUT /_security/user/{username}/_disable 
PUT /_security/user/jacknich/_disable

resp = client.security.disable_user(
    username="jacknich",
)
const response = await client.security.disableUser({
  username: "jacknich",
});
response = client.security.disable_user(
  username: "jacknich"
)
$resp = $client->security()->disableUser([
    "username" => "jacknich",
]);
curl -X PUT -H "Authorization: ApiKey $ELASTIC_API_KEY" "$ELASTICSEARCH_URL/_security/user/jacknich/_disable"