TorizonCloud API issue

Hello Toradex team,

I hope you are all doing great! And thank you for your support.

Hardware:

uname:

  • Linux 0146230000 5.15.177-6.8.2+git.5a6602cc6c32 #1-TorizonCore SMP PREEMPT Fri Mar 21 16:22:58 UTC 2025 aarch64 aarch64 aarch64 GNU/Linux

Images tested:

  • torizon-core-docker-verdin-imx8mp-Tezi_6.8.2+build.30.tar (STABLE Release)

Guest OS:

  • macOS (M1 Pro ARM64)

  • Linux ubuntu (VM x86_64)

Issue:

I’m facing an issue with the https://app.torizon.io/api/v2beta/devices. I’m unable to trigger the action to hibernate from the API with the following response:
``
{“code”:“403”,“name”:“FORBIDDEN”,“description”:“Requestor not allowed to PUT url: /api/v2beta/devices/hibernation/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX”}
```

I didn’t try all the actions provided in the API but most of the others work without any issue and I don’t see how I can change the permission to have more access.

I also tried by checking the API called from the platform (app.torizon.io) but its the same URL.

Thanks in advance for your help.

Best,
M

Hi, I’m the Toradex AI Assistant.

I might make mistakes. Our support team will step in if needed. If I answered your question, please tick the “Solution” checkbox. For follow-up questions to me, please use @ToradexAI in your post.

Did you like my answer? :+1: :-1:


Hibernation API Authentication Issue

The 403 FORBIDDEN error you’re encountering indicates an authentication issue with the hibernation API endpoint. According to the API documentation, the hibernation endpoint requires proper authentication(1).

API Requirements

The PUT /devices/hibernation/{deviceUuid} endpoint requires authentication via BearerAuth(1). The expected request body format is:

{
  "status": true
}

(1)

Understanding Hibernation Mode

When a device is hibernated, Torizon Cloud responds to almost all requests from the device with a 403 HTTP status(1). The hibernated device won’t be able to check for or receive updates, send metrics, or be available for remote access(1). Depending on your plan and billing contract, a hibernated device may not count towards your billable device quota(1).

Hibernation Features

Hibernated devices have different capabilities compared to online devices(2):

Feature Online Device Hibernated Device
No Upkeep Costs :cross_mark: :white_check_mark:
Device Provisioning :white_check_mark: :white_check_mark:
Fleet Management :white_check_mark: :white_check_mark:
Other Torizon Cloud Features :white_check_mark: :cross_mark:

Troubleshooting Steps

  1. Verify Authentication: Ensure you’re using a valid Bearer token with the correct permissions for device hibernation operations
  2. Check Device UUID: Confirm the device UUID in your request matches exactly with your provisioned device
  3. API Endpoint: Make sure you’re using the correct endpoint format: /devices/hibernation/{deviceUuid}

Common Use Cases

Hibernation mode is typically used to:

  • Decouple the provisioning process while flashing production devices in the factory from the start of incurring costs for online devices(2)
  • Provide OTA Updates, Remote Access, and other Torizon Cloud features as optional for your product(2)

The hibernation feature allows devices to be taken on and off hibernation mode via the Web Console or the API(2).

Best regards, Toradex AI Assistant.

Hi @unablesalt

Yeah…. I just tested it and got the same FORBIDDEN result.
I also tested some other endpoints, and the others worked.

Thanks for reporting it. I’ll check with the internal team.

Hello @allan.tx,

Thank you for your reply. I guess for now, I’ll remove and recreate the device with my script.

Would you be able to keep me updated when a fix is available?

Best,
M

Hello @allan.tx,

I come back to you if you and the team managed to fix it?

The only work around I have found would be to delete the device from Torizon and re-provisioning it and let’s be honest that’s not efficient..

Best regards,
M

Hello Maxence,

I just check internally, and it seems our team has fixed and merged this already.
let us know if how it goes with the new version

best regards

Maximiliano Zapata
Toradex

1 Like