メインコンテンツへスキップ
PATCH
/
api
/
v1
/
organizations
/
{organizationId}
/
devices
/
{deviceId}
Update device of an organization
curl --request PATCH \
  --url https://api.itmc.i.moneyforward.com/api/v1/organizations/{organizationId}/devices/{deviceId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fields": {
    "preset.asset_number": "(REQUIRED) - example value",
    "preset.subtype": "(REQUIRED) - desktop_pc",
    "preset.model_name": "(REQUIRED) - example value",
    "preset.serial_number": "example value",
    "preset.model_number": "example value",
    "preset.memory": "example value",
    "preset.hdd_ssd": "example value",
    "preset.cpu": "example value",
    "preset.os": "example value",
    "preset.size": "example value",
    "preset.manufacturer": "example value",
    "preset.supplier": "example value",
    "preset.procurement_method": "purchase",
    "preset.purchase_date": "2012-05-18",
    "preset.purchase_cost": "1234",
    "preset.warranty_period": "example value",
    "preset.decommission_date": "2012-05-18",
    "preset.scheduled_return_date": "2012-05-18",
    "preset.fixed_asset": "yes",
    "preset.phone_number": "example value",
    "preset.sim_number": "example value",
    "preset.mobile_plan": "example value",
    "preset.hostname": "example value",
    "preset.version": "example value",
    "preset.keyboard_layout": "us",
    "preset.usage_start_date": "2012-05-18",
    "preset.usage_end_date": "2012-05-18",
    "preset.status": "in_stock",
    "custom.custom_text_field": "foo",
    "custom.custom_date_field": "2024-01-01",
    "custom.custom_number_field": 123,
    "custom.custom_dropdown_field": "Option Displayed Value A"
  },
  "memo": "foo bar"
}
'
import requests

url = "https://api.itmc.i.moneyforward.com/api/v1/organizations/{organizationId}/devices/{deviceId}"

payload = {
    "fields": {
        "preset.asset_number": "(REQUIRED) - example value",
        "preset.subtype": "(REQUIRED) - desktop_pc",
        "preset.model_name": "(REQUIRED) - example value",
        "preset.serial_number": "example value",
        "preset.model_number": "example value",
        "preset.memory": "example value",
        "preset.hdd_ssd": "example value",
        "preset.cpu": "example value",
        "preset.os": "example value",
        "preset.size": "example value",
        "preset.manufacturer": "example value",
        "preset.supplier": "example value",
        "preset.procurement_method": "purchase",
        "preset.purchase_date": "2012-05-18",
        "preset.purchase_cost": "1234",
        "preset.warranty_period": "example value",
        "preset.decommission_date": "2012-05-18",
        "preset.scheduled_return_date": "2012-05-18",
        "preset.fixed_asset": "yes",
        "preset.phone_number": "example value",
        "preset.sim_number": "example value",
        "preset.mobile_plan": "example value",
        "preset.hostname": "example value",
        "preset.version": "example value",
        "preset.keyboard_layout": "us",
        "preset.usage_start_date": "2012-05-18",
        "preset.usage_end_date": "2012-05-18",
        "preset.status": "in_stock",
        "custom.custom_text_field": "foo",
        "custom.custom_date_field": "2024-01-01",
        "custom.custom_number_field": 123,
        "custom.custom_dropdown_field": "Option Displayed Value A"
    },
    "memo": "foo bar"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    fields: {
      'preset.asset_number': '(REQUIRED) - example value',
      'preset.subtype': '(REQUIRED) - desktop_pc',
      'preset.model_name': '(REQUIRED) - example value',
      'preset.serial_number': 'example value',
      'preset.model_number': 'example value',
      'preset.memory': 'example value',
      'preset.hdd_ssd': 'example value',
      'preset.cpu': 'example value',
      'preset.os': 'example value',
      'preset.size': 'example value',
      'preset.manufacturer': 'example value',
      'preset.supplier': 'example value',
      'preset.procurement_method': 'purchase',
      'preset.purchase_date': '2012-05-18',
      'preset.purchase_cost': '1234',
      'preset.warranty_period': 'example value',
      'preset.decommission_date': '2012-05-18',
      'preset.scheduled_return_date': '2012-05-18',
      'preset.fixed_asset': 'yes',
      'preset.phone_number': 'example value',
      'preset.sim_number': 'example value',
      'preset.mobile_plan': 'example value',
      'preset.hostname': 'example value',
      'preset.version': 'example value',
      'preset.keyboard_layout': 'us',
      'preset.usage_start_date': '2012-05-18',
      'preset.usage_end_date': '2012-05-18',
      'preset.status': 'in_stock',
      'custom.custom_text_field': 'foo',
      'custom.custom_date_field': '2024-01-01',
      'custom.custom_number_field': 123,
      'custom.custom_dropdown_field': 'Option Displayed Value A'
    },
    memo: 'foo bar'
  })
};

fetch('https://api.itmc.i.moneyforward.com/api/v1/organizations/{organizationId}/devices/{deviceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.itmc.i.moneyforward.com/api/v1/organizations/{organizationId}/devices/{deviceId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'fields' => [
        'preset.asset_number' => '(REQUIRED) - example value',
        'preset.subtype' => '(REQUIRED) - desktop_pc',
        'preset.model_name' => '(REQUIRED) - example value',
        'preset.serial_number' => 'example value',
        'preset.model_number' => 'example value',
        'preset.memory' => 'example value',
        'preset.hdd_ssd' => 'example value',
        'preset.cpu' => 'example value',
        'preset.os' => 'example value',
        'preset.size' => 'example value',
        'preset.manufacturer' => 'example value',
        'preset.supplier' => 'example value',
        'preset.procurement_method' => 'purchase',
        'preset.purchase_date' => '2012-05-18',
        'preset.purchase_cost' => '1234',
        'preset.warranty_period' => 'example value',
        'preset.decommission_date' => '2012-05-18',
        'preset.scheduled_return_date' => '2012-05-18',
        'preset.fixed_asset' => 'yes',
        'preset.phone_number' => 'example value',
        'preset.sim_number' => 'example value',
        'preset.mobile_plan' => 'example value',
        'preset.hostname' => 'example value',
        'preset.version' => 'example value',
        'preset.keyboard_layout' => 'us',
        'preset.usage_start_date' => '2012-05-18',
        'preset.usage_end_date' => '2012-05-18',
        'preset.status' => 'in_stock',
        'custom.custom_text_field' => 'foo',
        'custom.custom_date_field' => '2024-01-01',
        'custom.custom_number_field' => 123,
        'custom.custom_dropdown_field' => 'Option Displayed Value A'
    ],
    'memo' => 'foo bar'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.itmc.i.moneyforward.com/api/v1/organizations/{organizationId}/devices/{deviceId}"

	payload := strings.NewReader("{\n  \"fields\": {\n    \"preset.asset_number\": \"(REQUIRED) - example value\",\n    \"preset.subtype\": \"(REQUIRED) - desktop_pc\",\n    \"preset.model_name\": \"(REQUIRED) - example value\",\n    \"preset.serial_number\": \"example value\",\n    \"preset.model_number\": \"example value\",\n    \"preset.memory\": \"example value\",\n    \"preset.hdd_ssd\": \"example value\",\n    \"preset.cpu\": \"example value\",\n    \"preset.os\": \"example value\",\n    \"preset.size\": \"example value\",\n    \"preset.manufacturer\": \"example value\",\n    \"preset.supplier\": \"example value\",\n    \"preset.procurement_method\": \"purchase\",\n    \"preset.purchase_date\": \"2012-05-18\",\n    \"preset.purchase_cost\": \"1234\",\n    \"preset.warranty_period\": \"example value\",\n    \"preset.decommission_date\": \"2012-05-18\",\n    \"preset.scheduled_return_date\": \"2012-05-18\",\n    \"preset.fixed_asset\": \"yes\",\n    \"preset.phone_number\": \"example value\",\n    \"preset.sim_number\": \"example value\",\n    \"preset.mobile_plan\": \"example value\",\n    \"preset.hostname\": \"example value\",\n    \"preset.version\": \"example value\",\n    \"preset.keyboard_layout\": \"us\",\n    \"preset.usage_start_date\": \"2012-05-18\",\n    \"preset.usage_end_date\": \"2012-05-18\",\n    \"preset.status\": \"in_stock\",\n    \"custom.custom_text_field\": \"foo\",\n    \"custom.custom_date_field\": \"2024-01-01\",\n    \"custom.custom_number_field\": 123,\n    \"custom.custom_dropdown_field\": \"Option Displayed Value A\"\n  },\n  \"memo\": \"foo bar\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.patch("https://api.itmc.i.moneyforward.com/api/v1/organizations/{organizationId}/devices/{deviceId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"fields\": {\n    \"preset.asset_number\": \"(REQUIRED) - example value\",\n    \"preset.subtype\": \"(REQUIRED) - desktop_pc\",\n    \"preset.model_name\": \"(REQUIRED) - example value\",\n    \"preset.serial_number\": \"example value\",\n    \"preset.model_number\": \"example value\",\n    \"preset.memory\": \"example value\",\n    \"preset.hdd_ssd\": \"example value\",\n    \"preset.cpu\": \"example value\",\n    \"preset.os\": \"example value\",\n    \"preset.size\": \"example value\",\n    \"preset.manufacturer\": \"example value\",\n    \"preset.supplier\": \"example value\",\n    \"preset.procurement_method\": \"purchase\",\n    \"preset.purchase_date\": \"2012-05-18\",\n    \"preset.purchase_cost\": \"1234\",\n    \"preset.warranty_period\": \"example value\",\n    \"preset.decommission_date\": \"2012-05-18\",\n    \"preset.scheduled_return_date\": \"2012-05-18\",\n    \"preset.fixed_asset\": \"yes\",\n    \"preset.phone_number\": \"example value\",\n    \"preset.sim_number\": \"example value\",\n    \"preset.mobile_plan\": \"example value\",\n    \"preset.hostname\": \"example value\",\n    \"preset.version\": \"example value\",\n    \"preset.keyboard_layout\": \"us\",\n    \"preset.usage_start_date\": \"2012-05-18\",\n    \"preset.usage_end_date\": \"2012-05-18\",\n    \"preset.status\": \"in_stock\",\n    \"custom.custom_text_field\": \"foo\",\n    \"custom.custom_date_field\": \"2024-01-01\",\n    \"custom.custom_number_field\": 123,\n    \"custom.custom_dropdown_field\": \"Option Displayed Value A\"\n  },\n  \"memo\": \"foo bar\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.itmc.i.moneyforward.com/api/v1/organizations/{organizationId}/devices/{deviceId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fields\": {\n    \"preset.asset_number\": \"(REQUIRED) - example value\",\n    \"preset.subtype\": \"(REQUIRED) - desktop_pc\",\n    \"preset.model_name\": \"(REQUIRED) - example value\",\n    \"preset.serial_number\": \"example value\",\n    \"preset.model_number\": \"example value\",\n    \"preset.memory\": \"example value\",\n    \"preset.hdd_ssd\": \"example value\",\n    \"preset.cpu\": \"example value\",\n    \"preset.os\": \"example value\",\n    \"preset.size\": \"example value\",\n    \"preset.manufacturer\": \"example value\",\n    \"preset.supplier\": \"example value\",\n    \"preset.procurement_method\": \"purchase\",\n    \"preset.purchase_date\": \"2012-05-18\",\n    \"preset.purchase_cost\": \"1234\",\n    \"preset.warranty_period\": \"example value\",\n    \"preset.decommission_date\": \"2012-05-18\",\n    \"preset.scheduled_return_date\": \"2012-05-18\",\n    \"preset.fixed_asset\": \"yes\",\n    \"preset.phone_number\": \"example value\",\n    \"preset.sim_number\": \"example value\",\n    \"preset.mobile_plan\": \"example value\",\n    \"preset.hostname\": \"example value\",\n    \"preset.version\": \"example value\",\n    \"preset.keyboard_layout\": \"us\",\n    \"preset.usage_start_date\": \"2012-05-18\",\n    \"preset.usage_end_date\": \"2012-05-18\",\n    \"preset.status\": \"in_stock\",\n    \"custom.custom_text_field\": \"foo\",\n    \"custom.custom_date_field\": \"2024-01-01\",\n    \"custom.custom_number_field\": 123,\n    \"custom.custom_dropdown_field\": \"Option Displayed Value A\"\n  },\n  \"memo\": \"foo bar\"\n}"

response = http.request(request)
puts response.read_body
{
  "id": 123,
  "memo": "foo bar",
  "type": "pc",
  "people": {
    "id": 1,
    "primaryEmail": "foo@gmail.com",
    "displayName": "Yamaha Honda",
    "avatar": "avatar_url",
    "username": "foo",
    "type": "employee",
    "status": "suspended",
    "suspendedAt": "2021-07-13T19:15:40.000Z",
    "createdAt": "2021-07-13T19:15:40.000Z"
  },
  "identity": {
    "employeeStatus": "active",
    "employeeType": "full_time_employee",
    "firstName": "First Name",
    "lastName": "Last Name",
    "id": "<string>",
    "organizationId": 123,
    "peopleId": "<string>",
    "managementType": "managed",
    "displayName": "Display Name",
    "avatar": "<string>",
    "primaryEmail": "primay@email.com",
    "secondaryEmails": [
      "secondary+1@email.com",
      "secondary+2@email.com"
    ],
    "companyName": "company name",
    "workLocation": "work location",
    "department": {
      "name": "department name"
    },
    "serviceCount": 123,
    "deviceCount": 123,
    "costs": [
      {
        "amount": 100,
        "currency": "usd"
      }
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "isManager": true,
    "isMock": true,
    "isEmailEditable": true,
    "hasPresetFieldsUnlinked": true
  },
  "preset": {
    "subtype": "other",
    "price": 123.321
  },
  "custom": {
    "custom_text_field": "foo",
    "custom_date_field": "2024-01-01",
    "custom_number_field": 123,
    "custom_dropdown_field": "Option Displayed Value A"
  },
  "createdAt": "2024-03-20T00:00:00Z",
  "updatedAt": "2024-03-20T00:00:00Z",
  "customFieldsWithMetadata": [
    {
      "id": 1,
      "attributeCode": "custom_text_field",
      "attributeName": "Text field",
      "value": "foo"
    },
    {
      "id": 2,
      "attributeCode": "custom_date_field",
      "attributeName": "Date field",
      "value": "2024-01-01"
    },
    {
      "id": 3,
      "attributeCode": "custom_number_field",
      "attributeName": "Number field",
      "value": 123
    },
    {
      "id": 4,
      "attributeCode": "custom_dropdown_field",
      "attributeName": "Dropdown field",
      "value": "Option Displayed Value A"
    }
  ]
}

承認

​
Authorization
string
header
必須

For authenticated requests, set the Authorization: Bearer your_api_key parameter in the header.
You can create and manage your API Keys by visiting the API Keys tab in the Settings page of your organization in Admina

パスパラメータ

​
organizationId
number
必須
​
deviceId
number
必須

ボディ

application/json
​
fields
object
必須
​
memo
string
例:

"foo bar"

レスポンス

200 - application/json
​
id
number
必須

Unique identifier for the device

例:

123

​
memo
string
必須

Additional notes or memo about the device

例:

"foo bar"

​
type
enum<string>
必須

Type of the device (e.g., PC, Phone, Tablet)

利用可能なオプション:
pc,
phone,
other
例:

"pc"

​
people
object | null
必須

Person assigned to this device, or null if unassigned

​
identity
object | null
必須

Identity information of the assigned person, or null if unassigned

​
preset
object
必須

Preset fields for the device. This is a hashmap where the key maps to the field uniqueName in device fields.

例:
{ "subtype": "other", "price": 123.321 }
​
custom
object
必須

Custom fields for the device. This is a hashmap where the key maps to the field uniqueName in device fields.

例:
{
  "custom_text_field": "foo",
  "custom_date_field": "2024-01-01",
  "custom_number_field": 123,
  "custom_dropdown_field": "Option Displayed Value A"
}
​
createdAt
string<date-time>
必須

Timestamp when the device was created

例:

"2024-03-20T00:00:00Z"

​
updatedAt
string<date-time>
必須

Timestamp when the device was last updated

例:

"2024-03-20T00:00:00Z"

​
customFieldsWithMetadata
object[]
必須
read-only
例:
[
  {
    "id": 1,
    "attributeCode": "custom_text_field",
    "attributeName": "Text field",
    "value": "foo"
  },
  {
    "id": 2,
    "attributeCode": "custom_date_field",
    "attributeName": "Date field",
    "value": "2024-01-01"
  },
  {
    "id": 3,
    "attributeCode": "custom_number_field",
    "attributeName": "Number field",
    "value": 123
  },
  {
    "id": 4,
    "attributeCode": "custom_dropdown_field",
    "attributeName": "Dropdown field",
    "value": "Option Displayed Value A"
  }
]
最終更新日 2026年7月14日