Sign in

v1

latestOpenAPI 3.0.0Proprietary2026-08-06130577659.7 KB
Tools|Tool

Create/Update tools.

This method can be used to create and update tools.

An effort is made to locate an existing tool using the selected primary key. If found, it will be modified, whereas if no tool is found, a new one is created. If the deleteMissing flag is set to true, all tools absent from the request shall be purged. Please note that removed tools may not be reinstated. You can enable the dryRun setting to simulate the action without altering any live data.

The designated employee assigned in the tool will be accountable for the precise upkeep of the equipment. You may also configure purchaseCost, purchaseDate, warranty, and yearOfManufacture to facilitate your tool management. This data will be shown in geoCapture as tool details.

post/tool/upsert

Request body

deleteMissingboolean

Do you want to delete all tools missing from this request? This Parameter is optional. (Default: false)

dryRunboolean

Simulate the operation. (No records will be created or changed) This Parameter is optional.

Example request

{
  "records": [
    {
      "data": {
        "purchaseDate": "2015-02-20",
        "outgoingDate": "2015-02-20"
      }
    }
  ]
}

Response

Success Response:

Example response

{
  "createdTools": [
    {
      "currentProjectChangedAt": "2015-02-20T12:59:21+01:00",
      "createdAt": "2015-02-20T12:59:21+01:00",
      "beacon": {
        "lastSignalAt": "2015-02-20T12:59:21+01:00",
        "latLng": [
          52.38127828631681,
          7.594243214018696
        ],
        "estimatedPosition": [
          52.38127828631681,
          7.594243214018696
        ]
      },
      "tracker": {
        "lastSignalAt": "2015-02-20T12:59:21+01:00",
        "latLng": [
          52.38127828631681,
          7.594243214018696
        ]
      }
    }
  ],
  "updatedTools": [
    {
      "currentProjectChangedAt": "2015-02-20T12:59:21+01:00",
      "createdAt": "2015-02-20T12:59:21+01:00",
      "beacon": {
        "lastSignalAt": "2015-02-20T12:59:21+01:00",
        "latLng": [
          52.38127828631681,
          7.594243214018696
        ],
        "estimatedPosition": [
          52.38127828631681,
          7.594243214018696
        ]
      },
      "tracker": {
        "lastSignalAt": "2015-02-20T12:59:21+01:00",
        "latLng": [
          52.38127828631681,
          7.594243214018696
        ]
      }
    }
  ],
  "deletedTools": [
    {
      "currentProjectChangedAt": "2015-02-20T12:59:21+01:00",
      "createdAt": "2015-02-20T12:59:21+01:00",
      "beacon": {
        "lastSignalAt": "2015-02-20T12:59:21+01:00",
        "latLng": [
          52.38127828631681,
          7.594243214018696
        ],
        "estimatedPosition": [
          52.38127828631681,
          7.594243214018696
        ]
      },
      "tracker": {
        "lastSignalAt": "2015-02-20T12:59:21+01:00",
        "latLng": [
          52.38127828631681,
          7.594243214018696
        ]
      }
    }
  ]
}