REST API Reference

While the RasnuOS dashboard is incredibly powerful, enterprise platforms require programmatic access to integrate with existing internal tooling, CI/CD pipelines, and custom billing dashboards.

RasnuOS provides a comprehensive, deterministic REST API.

Authentication

To interact with the REST API, you must generate a Personal Access Token (PAT) from your user settings.

Because RasnuOS uses a strict Role-Based Access Control (RBAC) model, your API Token inherits your exact user permissions. If a junior engineer generates an API token, that token cannot trigger a deployment if the engineer only has the Viewer role.

All requests must include the token in the Authorization header:

curl -X GET https://os.rasnu.com/api/v1/servers \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"