Pico & Senti API Reference

This documentation is specific to Pico and Senti controllers only.

Base URL: https://api.illumience.com:11443
Protocol: HTTPS (TLS required)
Content-Type: application/json

Authentication

All endpoints require a valid API key passed via the Authorization header using the Bearer scheme.

Authorization: Bearer <api_key>

If the key is invalid, missing, or disabled, the server returns 401 Unauthorized.

Rate limiting: 60 requests per minute. The api_key_last_used_at timestamp is updated on each successful request.

Error Handling

All errors return a JSON object with a single error field:

{
  "error": "Description of what went wrong"
}

HTTP Status Codes