Rename, disable or re-enable a computer
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"
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Warehouse packing desk'})
};
fetch('https://api.printeasy.adfinite.com/v1/computers/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.printeasy.adfinite.com/v1/computers/{id}"
payload = { "name": "Warehouse packing desk" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"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"
}{
"error": {
"code": "not_found",
"message": "Printer not found",
"request_id": "4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a"
}
}{
"error": {
"code": "not_found",
"message": "Printer not found",
"request_id": "4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a"
}
}{
"error": {
"code": "not_found",
"message": "Printer not found",
"request_id": "4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a"
}
}{
"error": {
"code": "not_found",
"message": "Printer not found",
"request_id": "4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a"
}
}{
"error": {
"code": "not_found",
"message": "Printer not found",
"request_id": "4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a"
}
}Computers
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 --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"
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Warehouse packing desk'})
};
fetch('https://api.printeasy.adfinite.com/v1/computers/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.printeasy.adfinite.com/v1/computers/{id}"
payload = { "name": "Warehouse packing desk" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"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"
}{
"error": {
"code": "not_found",
"message": "Printer not found",
"request_id": "4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a"
}
}{
"error": {
"code": "not_found",
"message": "Printer not found",
"request_id": "4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a"
}
}{
"error": {
"code": "not_found",
"message": "Printer not found",
"request_id": "4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a"
}
}{
"error": {
"code": "not_found",
"message": "Printer not found",
"request_id": "4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a"
}
}{
"error": {
"code": "not_found",
"message": "Printer not found",
"request_id": "4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a"
}
}Authorizations
ApiKeyAuthBasicAuth
Send Authorization: Bearer <API key>. Use a pe_test_ key in the playground; it only reaches virtual test printers.
Path Parameters
Body
application/json
Changes
Response
The updated computer
Available options:
live, test Available options:
online, offline, disabled Was this page helpful?