REST API
SUPPORTFEEDBACK

[beta] 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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
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

Request body for recovering an asset.

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 23 days ago

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

Updated 23 days ago