Get device code status

Check whether a device code has been redeemed. Use this to poll for agent installation completion after creating an agent.

GET /agents/device-codes/{code}/status

cURL

cURL

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/agents/device-codes/{code}/status \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "code": "GRID-AGENT-X7K9-M2P4",
  "redeemed": false
}

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Path Parameters

code · string · required

The device code to check

Response

200

application/json

Successful operation

code · string · required

The device code.

Example:

"GRID-AGENT-X7K9-M2P4"

redeemed · boolean · required

Whether this device code has been redeemed.

Example:

false