Rename, disable or re-enable a computer

Renames a computer or disables it. Disabling disconnects the agent at once; re-enabling lets it reconnect and go online on its next ping.

PATCH /v1/computers/{id}

Rename, disable or re-enable a computer

cURL

curl --request PATCH \
  --url https://api.printeasy.adfinite.com/v1/computers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Warehouse packing desk"
}
'

200

{
  "agentVersion": "1.4.0",
  "arch": "amd64",
  "createdAt": "2026-10-01T08:30:00.000Z",
  "hostname": "PACK-01",
  "id": "0192f1a0-7c00-7000-8000-0000000000cc",
  "lastSeenAt": "2026-10-14T10:00:00.000Z",
  "mode": "live",
  "name": "Warehouse packing desk",
  "os": "windows",
  "osVersion": "10.0.26100",
  "state": "online"
}

Authorizations

ApiKeyAuthBasicAuth

Authorization · string · header · default: pe_test_REPLACE_WITH_YOUR_TEST_KEY · required

Send Authorization: Bearer <API key>. Use a pe_test_ key in the playground; it only reaches virtual test printers.

Path Parameters

id · string<uuid> · required

Body

application/json

Changes

disabled · boolean

true disconnects the agent and stops printing; false re-enables it

name · string

New display name

Required string length: 1 - 100

Response

200

application/json

The updated computer

agentVersion · string · required

arch · string · required

createdAt · string · required

hostname · string · required

id · string · required

lastSeenAt · string | null · required

mode · enum<string> · required

Available options: live, test

name · string · required

os · string · required

osVersion · string · required

state · enum<string> · required

Available options: online, offline, disabled