Unregister a computer
POST/computers/unregister
Removes the service account from the inventory record of a registered Windows computer.
The call queues a job that checks the supplied credentials, waits up to 90 seconds, and on success removes the service account from the computer's inventory record (the service account is dropped from its administrator list).
Required role: superadmin or admin; any other caller (plain user or no token) only while unauthenticated_registration_endpoints is enabled. Scoped API-key tokens are rejected (403).
The computer must already be registered. The lookup is by system (<cn>.<domain_fqdn>), case-insensitive.
The body can be JSON or urlencoded.
username and password are not validated up front: a request without them is queued and ends in the same 90 second timeout or scan failure. A system that matches no registered computer returns 422.
Request
Responses
- 200
- 401
- 403
- 408
- 422
Unregistered. The body is the last queue activity entry.
A token was sent but is invalid or expired (for example jwt malformed). A request with no token is not a 401 on this route: it returns 403 unless unauthenticated_registration_endpoints is enabled.
The token's role is not allowed for this operation, or the token's scopes exclude the route
(Scope not allowed by token).
The unregistration scan did not complete within 90 seconds. Body is {name: "TimeoutError", message: "Operation timed out"}.
Missing system, the request cannot be processed for the supplied computer (Unable to process the request), or the scan failed with the supplied credentials (message is the worker activity message and code its activity code).