Beta APIs

[beta] Mark an asset as missing.

Mark an asset as missing. Optionally specify a note and notification recipients who will receive email updates.

<b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).

To use this endpoint, select Write Assets under the Assets category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

post/fleet/assets/device-recovery/{id}/missing

Request

  • Base URL
    https://api.samsara.com
  • Auth
    HTTP bearer

Path parameters

idstring required

The ID of the asset. This can be a Samsara internal ID or an external ID in the format key:value.

Request body

notestring

Optional note when marking asset as missing.

Example request

{
  "note": "Asset was last seen at warehouse A",
  "notification_recipients": [
    {
      "notification_types": [
        "email"
      ],
      "user_id": 1234
    }
  ]
}

Response

OK response.

Example response

{
  "data": {
    "id": "12345",
    "initiated_at_ms": 1609459200000,
    "initiated_by_user_id": 1234,
    "name": "Trailer-A1234",
    "note": "Asset was last seen at warehouse A",
    "notification_recipients": [
      {
        "email": "jane.doe@example.com",
        "name": "Jane Doe",
        "notification_types": [
          "email"
        ],
        "user_id": 1234
      }
    ],
    "update_source": "dashboard",
    "updated_at_ms": 1609459200000,
    "updated_by_user_id": 1234
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.