POST Agents Reset
The POST /Agents/Reset method is used to reset one or more orchestrators, including:
- Remove all current orchestrator
Keyfactor orchestrators perform a variety of functions, including managing certificate stores and SSH key stores. jobs for the selected orchestrator(s).
- Delete all associated certificate stores.
- Set the orchestrator status to new.
- For orchestrators configured to use client certificate authentication, clear the certificate thumbprints stored for the orchestrator(s) to allow them to be reconfigured with a new certificate.
This endpoint An endpoint is a URL that enables the API to gain access to resources on a server. returns 204 with no content upon success. On a failure, a 400 is returned with an error message.
Table 110: POST Agents Reset Input Parameters
Name | In | Description |
---|---|---|
agentIds | Body | Required. An array of strings indicating the Keyfactor Command reference GUIDs of the orchestrators to reset. Use the GET /Agents method (see GET Agents) to retrieve a list of all the orchestrators to determine the orchestrator GUIDs. |


