v5

OpenAPI 3.1.0Proprietary2026-08-011476181.4 MB

Agent Management

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. Any previously issued unredeemed device codes for this agent are invalidated.

post/agents/{agentId}/device-codes

Response

New device code generated successfully

codestring required

Human-readable device code used to install and connect the agent software.

agentIdstring required

The agent this device code belongs to.

expiresAtstring date-time required

Timestamp when this device code expires.

redeemedboolean required

Whether this device code has already been redeemed by the agent.

Example response

{
  "code": "GRID-AGENT-X7K9-M2P4",
  "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000001",
  "expiresAt": "2025-07-22T17:32:28Z"
}