This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
Delete service account tokens API
editDelete service account tokens API
editDeletes service account tokens for a service
in a
specified namespace
.
Request
editDELETE /_security/service/<namespace>/<service>/credential/token/<token_name>
Prerequisites
edit-
To use this API, you must have at least the
manage_service_account
cluster privilege.
Description
editThe API response indicates whether the specified service account token is found and deleted or it is not found.
Path parameters
edit-
namespace
- (Required, string) Name of the namespace.
-
service
- (Required, string) Name of the service name.
-
token_name
- (Required, string) Name of the service account token.
Examples
editThe following request deletes the token1
service account token from the
elastic/fleet-server
service account:
resp = client.security.delete_service_token( namespace="elastic", service="fleet-server", name="token42", ) print(resp)
const response = await client.security.deleteServiceToken({ namespace: "elastic", service: "fleet-server", name: "token42", }); console.log(response);
DELETE /_security/service/elastic/fleet-server/credential/token/token42
If the service account token is successfully deleted, the request returns
{"found": true}
. Otherwise, the response will have status code 404
and
found` will be set to false
.
{ "found" : true }