ServicesConfig Store ServiceConfig Store APIadmin

Permanently delete all configs for a device

View as Markdown

Permanently delete all configuration files and version history for a device.

This action cannot be undone. All config versions (intended and backup) for the specified device will be removed from the database.

Authentication

AuthorizationBearer

Bearer JWT used by CLI and machine clients on svc-* endpoints. Authentication is required by default, but deployments may disable it with [auth] required = false. Browser OIDC sessions, mTLS, SPIFFE identities, and trusted gateway identity headers may also satisfy authentication outside this generated client flow.

Path parameters

device_uuidstringRequiredformat: "uuid"

Response

Successful Response
deleted_versionsinteger
Number of config versions deleted
device_uuidstring
Device UUID
messagestring

Human-readable result message

Errors

422
Unprocessable Entity Error