API

Integrate with hav.sh using the REST API.

hav.sh provides a REST API that lets you manage your Odoo services programmatically. The API uses Bearer token authentication via Laravel Sanctum.

#Interactive documentation

The full API reference with all endpoints, request parameters, and response schemas is available as interactive OpenAPI documentation:

Open API Reference Browse all endpoints, try requests, and view response schemas.

You can also download the OpenAPI specification as JSON at /docs/api.json to import into tools like Postman or Insomnia.

#Authentication

Include your API token in the Authorization header of every request:

Authorization: Bearer your-api-token

API tokens can be created in Team Settings > API Tokens. Tokens inherit the permissions of the user who created them.

Store your API token securely. It grants access to your team's resources. If a token is compromised, delete it immediately and create a new one.

#Quick example

curl https://your-instance.hav.sh/api/service-odoo \
  -H "Authorization: Bearer your-api-token" \
  -H "Accept: application/json"
Notifications