Helios Documentation

Troubleshooting & FAQ

Get help with common issues and contact support.

Deployment Issues

Billing Issues

Frontend-Exposed Error Codes

This section details the error codes and messages that can be exposed to the frontend from the container and image registry APIs.

Container Creation Errors

HTTP Status CodeError MessageDescription
400 Bad RequestInvalid request formatThe request body sent for container creation is malformed or missing required fields.
400 Bad RequestInvalid workspace tag formatThe provided workspace tag is not a valid UUID format.
400 Bad RequestInvalid workspace tagThe provided workspace tag does not correspond to an existing workspace.
400 Bad RequestInvalid image tag formatThe provided container image ID is not a valid UUID format.
400 Bad RequestInvalid image tagThe provided container image ID does not correspond to an existing image.

Image Creation Errors

HTTP Status CodeError MessageDescription
400 Bad RequestInvalid request bodyThe request body sent for creating a container image is malformed or missing required fields.

Image Deletion Errors

HTTP Status CodeError MessageDescription
400 Bad RequestFailed to parse tagThe provided image tag is not a valid UUID format.
404 Not FoundNo container image found with specified tagNo container image exists with the provided tag.
409 ConflictCannot delete image - containers are still runningThe image cannot be deleted because one or more containers are currently using it.

Image Listing Errors

HTTP Status CodeError MessageDescription
400 Bad RequestInvalid workspace ID formatThe provided workspace ID is not a valid UUID format.

Image Tag Listing Errors (by Image Tag)

HTTP Status CodeError MessageDescription
400 Bad RequestInvalid image tagThe provided image tag is not a valid UUID format.

Image Tag Listing Errors (by Workspace Tag)

HTTP Status CodeError MessageDescription
400 Bad RequestInvalid workspace ID formatThe provided workspace ID is not a valid UUID format.

Our support team is here to help.

  • In-dashboard chat: For the fastest response (typically under 5 minutes).
  • Email: support@helios.com (response within 24 hours).