REST API
SUPPORTFEEDBACK

[preview] Mark an asset as recovered.

post
https://api.samsara.com/fleet/assets/device-recovery//recovered

Mark a missing asset as recovered. Provide the recovery status, reason for being missing, and optional additional details.

Rate limit: 100 requests/min (learn more about rate limits here).

To use this endpoint, select Write Assets under the Assets category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

Path Params
string
required

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

Body Params
string

Optional additional details about the recovery.

string
enum
required

The reason the asset was marked as missing. Valid values: MISPLACED, STOLEN, NOT_SURE

Allowed:
string
enum
required

Whether the asset has been physically recovered. Valid values: YES, NO, NOT_SURE

Allowed:
string
enum
required

The recovery status to set for the asset. Valid values: RECOVERED

Allowed:
Responses

Updated 30 days ago

Language
Credentials
Bearer
URL
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 30 days ago