Labs: SmartThings Health and Battery Reports

[josh]

Are you interested in the Battery or Offline status? For the battery, there might be an alternative approach where you setup rule(s) to track the battery status directly instead of using this special aggregation endpoint.

[JKB121]

@josh

Check the last section of the original post.

I went with this:

BatteryMonitor
BatteryMonitor SmartApp for Hubitat
Version 1.1
Author Brandon Gordon, larry kahn

[JKB121]

@josh

Anyone with an existing Personal Access Token (PAT) seems to be grandfathered in and those keep their original long life, but the newer tokens are the short 24 hours.

I was curious about this so I enabled an existing rule that incorporated the health check from over a year ago. It returned a 403 error which I believe indicates an authorization issue. It did not work, so I don’t think my existing PAT is grandfathered…

[josh]

@JKB121

I enabled an existing rule that incorporated the health check from over a year ago. It returned a 403 error which I believe indicates an authorization issue.

From the linked thread, it looks like existing PATs from before December 2024 should still work:

These changes only impact newly issued PATs. As of now we’re not making any changes to existing PATs.
…
We don’t want to break that functionality and before we would consider making any changes to existing PATs, we’d want to have a paved path to keep our users’ locations functioning reliably.

An HTTP 403 means Forbidden. In other words, their API understands your request but refuses to authorize it due to a lack of permission for the expected resource – the most common case for this is not having one of the required permissions (eg. List and See All Devices) which you would have needed to explicitly granted when the PAT was originally created.

@josh

To do so, you’ll need a SmartThings Personal Access Token with at least the List and See All Devices access

Normally if the token was fundamentally invalid, I would expect an HTTP 401 which means Unauthorized and is commonly used when no credentials are supplied or the credentials are invalid / expired.

[Bob_Gross]

Hi Josh,

It’s the ‘offline’ I’m interested in. I already have a SmartThings routine to check battery status but I can’t do offline checks.

Thanks,

Bob