Regenerate a device code
Generate a new device code for an existing agent. Use this when the original device code has expired before being redeemed, or when the agent software needs to be reinstalled. An agent has at most one unredeemed device code, so regenerating invalidates the one issued before it.
Authorizations
API token authentication using format <api token id>:<api client secret>
Path Parameters
System-generated unique agent identifier
Response
New device code generated successfully
Device code used to install and connect the agent software: an opaque 22-character URL-safe base64 string encoding 128 random bits. It is returned only when it is issued, because Grid stores only a hash of it; if it is lost before it is redeemed, regenerate it. It can be redeemed once.
"jqzJR3AgI9OAwb_enypARw"
The agent this device code belongs to.
"Agent:019542f5-b3e7-1d02-0000-000000000001"
Timestamp when this device code expires. Codes expire 15 minutes after they are issued by default; Grid can configure a platform's lifetime between 1 and 60 minutes.
"2025-07-22T17:32:28Z"
Whether this device code has already been redeemed by the agent.
false