Assets

Update an Asset

Changed on

OAuth Scope

This endpoint requires the following OAuth scope manage_assets.

post/asset/{uuid}.json

Request

  • Base URL
    https://api.servicem8.com/api_1.0
  • URL
    https://api.servicem8.com/api_1.0/asset/{uuid}.json
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.servicem8.com/oauth/authorize
      Token URL: https://api.servicem8.com/oauth/access_token scopes: manage_assets

Path parameters

uuidstring uuid required

UUID of the Asset

Request body

uuidstring uuid

Unique identifier for this record

company_uuidstring uuid

UUID of the Client to which this Asset is attached

namestring

User-facing description of this asset

latnumber float

Latitude component of the Asset's location in degrees

lngnumber float

Longitude component of the Asset's location in degrees

geo_timestampstring

Timestamp at which the Asset's location was last updated

altitudenumber

Altitude component of the Asset's location in metres

Example request

{
  "uuid": "123e4567-18c8-451f-879d-23f9421d865b",
  "company_uuid": "123e4567-fbc9-4ae2-b9d1-23f9463186cb",
  "geo_timestamp": "2026-03-01 12:00:00"
}

Response

Success - The record was updated successfully

errorCodenumber
messagestring

Example response

{
  "message": "OK"
}

Changes

  • 638a8df09bf4Revision changes
    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

  • ca9b053c4373Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status