v13

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-04237161688.6 KB

Machines

Rotate a machine's secret key

Rotates the machine's secret key. When the secret key is rotated, make sure to update it in your machine/application. The previous secret key will remain valid for the duration specified by the previous_token_ttl parameter.

post/machines/{machine_id}/secret_key/rotate

Path parameters

machine_idstring required

The ID of the machine to rotate the secret key for

Request body

previous_token_ttlinteger required

The time in seconds that the previous secret key will remain valid after rotation. This ensures a graceful transition period for updating applications with the new secret key. Set to 0 to immediately expire the previous key. Maximum value is 8 hours (28800 seconds).

Response

Success

object'machine_secret_key' required

String representing the object's type.

secretstring required

The secret key for the machine.