Update an asset

PATCH

assets

{id}

Update an asset

curl --request PATCH \
  --url https://api.oncanary.com/v1/assets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "name": "<string>",
  "description": "<string>",
  "image_url": "<string>",
  "image_blur": "<string>",
  "location_id": "<string>",
  "serial_number": "<string>",
  "manufacturer": "<string>",
  "model": "<string>",
  "year": 1963,
  "extraFields": {}
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    code: '<string>',
    name: '<string>',
    description: '<string>',
    image_url: '<string>',
    image_blur: '<string>',
    location_id: '<string>',
    serial_number: '<string>',
    manufacturer: '<string>',
    model: '<string>',
    year: 1963,
    extraFields: {}
  })
};

fetch('https://api.oncanary.com/v1/assets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.oncanary.com/v1/assets/{id}"

payload = {
    "code": "<string>",
    "name": "<string>",
    "description": "<string>",
    "image_url": "<string>",
    "image_blur": "<string>",
    "location_id": "<string>",
    "serial_number": "<string>",
    "manufacturer": "<string>",
    "model": "<string>",
    "year": 1963,
    "extraFields": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "asset_type": "<string>",
    "asset_types": [
      {
        "id": "<string>",
        "name": "<string>"
      }
    ],
    "status": "online",
    "criticality": "critical",
    "serial_number": "<string>",
    "manufacturer": "<string>",
    "model": "<string>",
    "year": 123,
    "location_id": "<string>",
    "parent_asset_id": "<string>",
    "sub_asset_count": 1,
    "deleted_at": "2023-11-07T05:31:56Z",
    "image_url": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "code": "<string>",
    "extraFields": {}
  },
  "meta": {
    "request_id": "<string>",
    "api_version": "<string>"
  }
}

{
  "type": "https://api.oncanary.com/errors/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "request_id": "req_01JAY8FVDM6CH4R3X9Q2T7K5NP",
  "code": "validation_error"
}

{
  "type": "https://api.oncanary.com/errors/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "request_id": "req_01JAY8FVDM6CH4R3X9Q2T7K5NP",
  "code": "validation_error"
}

{
  "type": "https://api.oncanary.com/errors/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "request_id": "req_01JAY8FVDM6CH4R3X9Q2T7K5NP",
  "code": "validation_error"
}

{
  "type": "https://api.oncanary.com/errors/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "request_id": "req_01JAY8FVDM6CH4R3X9Q2T7K5NP",
  "code": "validation_error"
}

{
  "type": "https://api.oncanary.com/errors/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "request_id": "req_01JAY8FVDM6CH4R3X9Q2T7K5NP",
  "code": "validation_error"
}

Authorizations

Authorization

string

header

required

Organization API key with an sk_live_ or sk_test_ prefix

Path Parameters

string

required

Resource ID

Body

application/json

code

string

Editable customer-facing ID, unique across assets, parts and location scan payloads within the organization. Generated when omitted at creation. Changing it invalidates labels using the previous ID; internal record IDs and linked work stay unchanged.

Required string length: 1 - 255

name

string

Maximum string length: 255

asset_type

enum<string>

Available options:

equipment,

vehicle,

facility

status

enum<string>

Available options:

online,

offline,

not_monitored

downtime_type

enum<string>

Required when changing an asset to offline. Updates classification on its active interval; historical intervals are unchanged.

Available options:

planned,

unplanned

criticality

enum<string>

Available options:

critical,

important,

normal

description

string | null

Maximum string length: 1000

image_url

string | null

Maximum string length: 2000

image_blur

string | null

location_id

string | null

serial_number

string | null

Maximum string length: 255

manufacturer

string | null

Maximum string length: 255

model

string | null

Maximum string length: 255

year

integer | null

Manufacturing year, through the next calendar year

Required range: 1900 <= x <= 2027

extraFields

object

Label-keyed custom-field values. Omitted labels remain unchanged on update.

Show child attributes

Response

Asset updated

data

object

required

Show child attributes

meta

object

required

Show child attributes

Update an asset

curl --request PATCH \
  --url https://api.oncanary.com/v1/assets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "name": "<string>",
  "description": "<string>",
  "image_url": "<string>",
  "image_blur": "<string>",
  "location_id": "<string>",
  "serial_number": "<string>",
  "manufacturer": "<string>",
  "model": "<string>",
  "year": 1963,
  "extraFields": {}
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    code: '<string>',
    name: '<string>',
    description: '<string>',
    image_url: '<string>',
    image_blur: '<string>',
    location_id: '<string>',
    serial_number: '<string>',
    manufacturer: '<string>',
    model: '<string>',
    year: 1963,
    extraFields: {}
  })
};

fetch('https://api.oncanary.com/v1/assets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.oncanary.com/v1/assets/{id}"

payload = {
    "code": "<string>",
    "name": "<string>",
    "description": "<string>",
    "image_url": "<string>",
    "image_blur": "<string>",
    "location_id": "<string>",
    "serial_number": "<string>",
    "manufacturer": "<string>",
    "model": "<string>",
    "year": 1963,
    "extraFields": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "asset_type": "<string>",
    "asset_types": [
      {
        "id": "<string>",
        "name": "<string>"
      }
    ],
    "status": "online",
    "criticality": "critical",
    "serial_number": "<string>",
    "manufacturer": "<string>",
    "model": "<string>",
    "year": 123,
    "location_id": "<string>",
    "parent_asset_id": "<string>",
    "sub_asset_count": 1,
    "deleted_at": "2023-11-07T05:31:56Z",
    "image_url": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "code": "<string>",
    "extraFields": {}
  },
  "meta": {
    "request_id": "<string>",
    "api_version": "<string>"
  }
}

{
  "type": "https://api.oncanary.com/errors/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "request_id": "req_01JAY8FVDM6CH4R3X9Q2T7K5NP",
  "code": "validation_error"
}

{
  "type": "https://api.oncanary.com/errors/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "request_id": "req_01JAY8FVDM6CH4R3X9Q2T7K5NP",
  "code": "validation_error"
}

{
  "type": "https://api.oncanary.com/errors/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "request_id": "req_01JAY8FVDM6CH4R3X9Q2T7K5NP",
  "code": "validation_error"
}

{
  "type": "https://api.oncanary.com/errors/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "request_id": "req_01JAY8FVDM6CH4R3X9Q2T7K5NP",
  "code": "validation_error"
}

{
  "type": "https://api.oncanary.com/errors/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "request_id": "req_01JAY8FVDM6CH4R3X9Q2T7K5NP",
  "code": "validation_error"
}

API essentials

Work management

Equipment

Inventory

Organization data

Authorizations

Path Parameters

Body

Response