Remove or deduplicate an SSH key for a specific user on a specific host

post

https://{sandfly-api-host}/v4/responseaction/sshpubkey/{keyid}/{action}/host/{host_sequence_id}/user/{username}

Performs an SSH key response action for a specific user on a specific host. Requires the responder role. For 'remove' actions, a last-key protection safety check denies the request with HTTP 409 if the host would be left with zero SSH keys known to Sandfly after removing the key for this user; set allow_last_key_removal=true in the request body to override.

Responses

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

202Action queued for the specified user on the specified host.

400Key has no stored value, host is inactive, or no placements found.

403Insufficient role or response actions disabled.

404Key, host, or user placement not found.

409Last-key protection: removing the key for this user would leave the host with no SSH keys known to Sandfly. The response body identifies the affected host and user. Set allow_last_key_removal=true in the request body to override.

defaultUnexpected error