Get device code status

Check the status of a device code. Use this to poll for agent installation completion after creating an agent.

POST /agents/device-codes/status

Get device code status

cURL

curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/agents/device-codes/status \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "jqzJR3AgI9OAwb_enypARw"
}
'

200

{
  "code": "jqzJR3AgI9OAwb_enypARw",
  "status": "PENDING",
  "redeemed": false
}

Authorizations

Authorization · string · header · required

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

Body

application/json

code · string · required

The device code.

Example:

"jqzJR3AgI9OAwb_enypARw"

Response

200

application/json

Successful operation

code · string · required

The device code.

Example:

"jqzJR3AgI9OAwb_enypARw"

status · enum<string> · required

The current status of the device code.

• PENDING: The code is active and has not been redeemed.
• REDEEMED: The code was successfully redeemed.
• EXPIRED: The code expired before it was redeemed.
• INVALIDATED: The code was superseded or otherwise invalidated before it was redeemed.

Available options: PENDING, REDEEMED, EXPIRED, INVALIDATED

Example:

"PENDING"

redeemed · boolean · required

Whether this device code was successfully redeemed. This is false for expired or invalidated codes.

Example:

false