Update Machine

Beta

PATCH/v1/operations/machines/{id}

Idempotent with Idempotency-Key header. Learn more

Partially updates a machine.

Only the fields provided in the request are changed. Returns a conflict error if the new name is already in use by another machine in your account. A machine cannot be moved to a different department.

Permission requiredValues:machines:update

The role behind your API key or agent must grant this permission.

idstring

ID of the machine to update.

include[]optional arrayenumValues:department

Sub-objects to expand in the response. When omitted, sub-objects are returned as null.

nameoptional string

Display name of the machine.

Must be unique within your account; maximum 255 characters.

serial_numberoptional string

Serial number of the machine.

Maximum 255 characters.

notesoptional stringnullable

Free-form notes about the machine.

Send null to clear. Send null to clear.

idstring

Machine ID.

objectstringenumValues:machine

Resource type identifier.

namestring

Display name of the machine.

Unique within the account.

serial_numberstring

Serial number of the machine.

notesstringnullable

Free-form notes about the machine.

departmentdepartmentExpandablenullable

The department this machine belongs to.

Set when the machine is created; a machine cannot be moved to another department afterwards.

idstring

Department ID.

objectstringenumValues:department

Resource type identifier.

namestring

Display name of the department.

Unique within the account.

notesstringnullable

Free-form notes about the department.

locationlocationnullable

The storage location where this department operates.

Always returned as null in this endpoint.

scanning_stationslistnullable

Scanning stations in this department.

Always returned as null in this endpoint.

machineslistnullable

Machines in this department.

Always returned as null in this endpoint.

labor_rateratenullable

Hourly labor rate for work done in this department, such as a changeover technician.

Production scheduling costs changeovers with the constraint department's rate when one is set, falling back to the account-wide changeover labor rate setting.

Null unless the caller holds costs:read; customer and supplier portal users never see it.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last update timestamp.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

200

Successful response for Update Machine

Update Machine

import OpenMRP from '@openmrp/sdk';

const client = new OpenMRP({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const machine = await client.operations.machines.update('mc_ffcfk9dxixis', {
  name: 'Updated CNC Router',
});

console.log(machine.id);

import OpenMRP from '@openmrp/sdk';

const client = new OpenMRP({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const machine = await client.operations.machines.update('mc_ffcfk9dxixis', {
  name: 'Updated CNC Router',
});

console.log(machine.id);

200 example

{
  "id": "mc_ffcfk9dxixis",
  "object": "machine",
  "name": "CNC Router",
  "serial_number": "SN-2024-0001",
  "notes": "Spindle rebuilt March 2026; torque calibration due quarterly.",
  "department": null,
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

{
  "id": "mc_ffcfk9dxixis",
  "object": "machine",
  "name": "CNC Router",
  "serial_number": "SN-2024-0001",
  "notes": "Spindle rebuilt March 2026; torque calibration due quarterly.",
  "department": null,
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

Update Machine

Authorization

Path Parameters

Query Parameters

Request Body

Returns

Responses